SFI External API — Hồ sơ chuyên gia

X-Api-Key: {api_key_được_SFI_cấp}

{
  "success": true,
  "message": "Thành công!",
  "data": [ ... ],
  "svr": "srv-01"
}

Hồ sơ giới thiệu của nhân sự SFI (môi giới, cộng tác viên, đại lý, nhân sự đối tác) — ảnh, chức danh, giới thiệu, triết lý đầu tư, dịch vụ cung cấp, thông tin nổi bật và hồ sơ kinh nghiệm. Nhân sự tự điền trên cổng AMG, bộ phận CSKH của SFI duyệt trước khi công khai.

1 · Bảng nhãn khoá động

Hai nhóm highlights / experience trong hồ sơ dùng khoá động do SFI khai: khoá có thể được thêm, đổi nhãn hoặc ẩn bất cứ lúc nào. Bảng nhãn này giống nhau cho mọi hồ sơ nên nằm ở endpoint riêng — gọi một lần, cache lại, rồi dùng cho toàn bộ danh sách và chi tiết. Hai API hồ sơ ở dưới chỉ trả value, không lặp lại bảng nhãn.

Request

curl 'https://a.sfi.com.vn/ekyc/ex_api?cmd=expert_profile_fields' \
  -H 'X-Api-Key: YOUR_API_KEY'

Response

{
  "success": true,
  "message": "Thành công!",
  "data": {
    "HIGHLIGHT": [
      { "key": "years_experience", "label": "Số năm kinh nghiệm", "icon": "briefcase", "inputType": "TEXT" },
      { "key": "clients_served",   "label": "Số nhà đầu tư đồng hành", "icon": "users", "inputType": "TEXT" }
    ],
    "EXPERIENCE": [
      { "key": "aum",    "label": "Tổng tài sản đang quản lý", "icon": "", "inputType": "TEXT" },
      { "key": "awards", "label": "Vinh danh - Giải thưởng",   "icon": "", "inputType": "MULTILINE" }
    ]
  },
  "svr": "srv-01"
}

2 · Danh sách chuyên gia

Trả về danh sách chuyên gia theo trang, kèm toàn bộ nội dung hồ sơ của từng người — không cần gọi thêm API chi tiết để dựng danh sách hay trang giới thiệu.

Tham số truy vấn

Request

# Trang 1, 20 chuyên gia, khối lượng giao dịch lớn nhất trước
curl 'https://a.sfi.com.vn/ekyc/ex_api?cmd=expert_profiles&page=1&size=20&sort=volume' \
  -H 'X-Api-Key: YOUR_API_KEY'

# Nhiều khách hàng nhất
curl 'https://a.sfi.com.vn/ekyc/ex_api?cmd=expert_profiles&sort=clients' \
  -H 'X-Api-Key: YOUR_API_KEY'

# Tìm theo tên (không dấu) hoặc số điện thoại — nhớ URL-encode q
curl 'https://a.sfi.com.vn/ekyc/ex_api?cmd=expert_profiles&q=nguyen%20van' \
  -H 'X-Api-Key: YOUR_API_KEY'
curl 'https://a.sfi.com.vn/ekyc/ex_api?cmd=expert_profiles&q=0901234' \
  -H 'X-Api-Key: YOUR_API_KEY'

Response

{
  "success": true,
  "message": "Thành công!",
  "data": {
    "items": [
      {
        "id": "MG0123",
        "name": "Nguyễn Văn An",
        "phone": "0901234567",
        "branch": "Chi nhánh Hồ Chí Minh",
        "avatar": "https://img.saigonfutures.com/uploads/ab12-portrait.jpg",
        "age": 32,
        "jobTitle": "Chuyên viên tư vấn đầu tư hàng hóa cấp cao",
        "intro": "Xin chào Quý Nhà đầu tư,\n\nTôi là…",
        "philosophy": "Kỷ luật - Quản trị rủi ro - Tăng trưởng bền vững",
        "styles": [
          { "icon": "shield-check", "title": "Kỷ luật", "subtitle": "Đặt nguyên tắc lên hàng đầu" }
        ],
        "services": [
          "Xây dựng kế hoạch đầu tư phù hợp với mục tiêu và khẩu vị rủi ro của khách hàng."
        ],
        "highlights":   { "years_experience": "8+", "clients_served": "650+" },
        "experience":   { "aum": "Đến 100 tỷ", "awards": ["Top 1 - Bảng vàng 2025"] },
        "stats": { "month": "08-2026", "volume": 1284, "clients": 37 },
        "publishedAt": "2026-08-12 14:05:22"
      }
    ],
    "paging": { "page": 1, "size": 20, "total": 57, "totalPages": 3 },
    "q": "",
    "sort": "volume",
    "order": "desc",
    "statsMonth": "08-2026"
  },
  "svr": "srv-01"
}

3 · Chi tiết một chuyên gia

Trả về hồ sơ của đúng một chuyên gia. Nội dung giống hoàn toàn một phần tử trong items của API danh sách (mục 2.2) — API này chỉ tiện khi đối tác đã có mã nhân sự (ví dụ mã môi giới phụ trách một khách hàng) và không muốn tải cả danh sách.

Tham số truy vấn

Request

curl 'https://a.sfi.com.vn/ekyc/ex_api?cmd=expert_profile&id=MG0123' \
  -H 'X-Api-Key: YOUR_API_KEY'

Response

{
  "success": true,
  "message": "Thành công!",
  "data": {
    "expert": { "...": "cùng cấu trúc với một phần tử items ở mục 2.2" },
    "statsMonth": "08-2026"
  },
  "svr": "srv-01"
}

4 · Sắp xếp theo số liệu tháng

Hai tiêu chí sắp xếp đều là số liệu giao dịch của tháng hiện tại (tháng ghi ở statsMonth, định dạng MM-YYYY), tính lại ở mỗi lần gọi:

5 · Trường dữ liệu chuyên gia

Mã lỗi riêng của nhóm

const BASE = 'https://a.sfi.com.vn/ekyc/ex_api';
const HEADERS = { 'X-Api-Key': process.env.SFI_API_KEY };

async function call(params) {
  const qs  = new URLSearchParams(params);
  const res = await fetch(`${BASE}?${qs}`, { headers: HEADERS });
  const body = await res.json();
  if (!body.success) throw new Error(body.message);
  return body.data;
}

// Bảng nhãn khoá động — gọi một lần rồi cache
const fields = await call({ cmd: 'expert_profile_fields' });

// Danh sách + chi tiết hồ sơ
const experts = await call({ cmd: 'expert_profiles', page: 1, size: 20, sort: 'volume', order: 'desc' });
const profile = await call({ cmd: 'expert_profile', id: experts.items[0].id });

function sfiCall(array $params) {
    $url = 'https://a.sfi.com.vn/ekyc/ex_api?' . http_build_query($params);

    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER     => ['X-Api-Key: ' . getenv('SFI_API_KEY')],
        CURLOPT_TIMEOUT        => 10,
    ]);
    $body = json_decode(curl_exec($ch), true);
    curl_close($ch);

    if (empty($body['success'])) {
        throw new RuntimeException($body['message'] ?? 'SFI API error');
    }
    return $body['data'];
}

$experts = sfiCall(['cmd' => 'expert_profiles', 'page' => 1, 'size' => 20, 'sort' => 'volume']);