SFI External API — Banner app SFI Trade

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

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

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

{
  "success": true,
  "message": "Thành công!",
  "data": {
    "top": [
      { "order": 1, "image": "https://img.saigonfutures.com/uploads/ab12-banner-top-1.jpg" },
      { "order": 2, "image": "https://img.saigonfutures.com/uploads/cd34-banner-top-2.jpg" }
    ],
    "body": [
      { "order": 1, "image": "https://img.saigonfutures.com/uploads/ef56-banner-body-1.jpg" }
    ],
    "academy": [
      { "order": 1, "image": "https://img.saigonfutures.com/uploads/gh78-banner-academy-1.jpg" }
    ],
    "expert": [
      { "order": 1, "image": "https://img.saigonfutures.com/uploads/ij90-banner-expert-1.jpg" }
    ]
  },
  "svr": "srv-01"
}

Khuyến nghị tích hợp

• Gọi API từ máy chủ của đối tác, không gọi trực tiếp từ trình duyệt / app để tránh lộ API Key.
• Luôn kiểm tra success trước khi đọc data; ghi lại svr khi cần báo lỗi cho SFI.
• Cache dữ liệu ít thay đổi (ví dụ news_products) và đặt TTL tối thiểu 1–5 phút cho dữ liệu danh sách.
• Đồng bộ tăng dần bằng cách lưu id lớn nhất đã lấy và dừng khi gặp lại id đó.
• Tôn trọng giới hạn phân trang (size ≤ 100) thay vì kéo toàn bộ kho dữ liệu trong một lần.
• Đặt timeout hợp lý (5–10s) và retry có backoff; nếu domain chính chậm > 5s, chuyển sang domain dự phòng.

Ví dụ code

Hàm gọi chung dưới đây dùng được cho mọi endpoint công khai của /ekyc/ex_api — chỉ thay cmd và tham số.

JavaScript (server-side / Node.js)

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;
}

// Một lần gọi trả đủ banner của cả bốn vị trí
const banners = await call({ cmd: 'banners' });
renderCarousel(banners.top);
renderCarousel(banners.body);

PHP

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'];
}

$banners = sfiCall(['cmd' => 'banners']);