Đến nội dung
BankGatewayBankGateway
Console ↗
↑ ↓ Điều hướng↵ ChọnEsc Đóng
Mục lục tài liệu:Xác thực API Key ▾
Tài liệu›Xác thực & Bảo mật›Xác thực API Key
Phiên bản:v1.0.5 (Chính thức)

Hướng dẫn sử dụng khóa bí mật X-API-Key, cấu hình an toàn và quản lý vòng đời khóa.

Headers yêu cầu trong mỗi Request

HeaderBắt buộcMô tả & Chuẩn
X-API-KeyBắt buộcKhóa bí mật API cấp riêng cho tài khoản. Chỉ truyền từ server-to-server.
Content-TypeBắt buộcapplication/json; charset=utf-8
Idempotency-KeyKhuyến nghị caoUUID v4 duy nhất cho mỗi giao dịch (RFC 8470). Chống trừ tiền trùng lặp khi mạng lag.
HTTP Headers
X-API-Key: bg_live_8f3a9e2d1c4b7a6f...
Content-Type: application/json
Idempotency-Key: 9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d

Quy tắc quản lý vòng đời khóa

  1. 01
    Tách biệt khóa theo môi trường

    Tạo khóa riêng cho môi trường Staging/Dev và khóa riêng cho Production để kiểm soát hạn mức độc lập.

  2. 02
    Cấu hình IP Whitelist cho Production

    Chỉ định rõ địa chỉ IP tĩnh của máy chủ backend. Không bao giờ để trống trên môi trường thực tế.

  3. 03
    Thu hồi và đổi khóa định kỳ

    Nếu nghi ngờ lộ khóa, bạn có thể tạo khóa mới và xóa khóa cũ ngay trên Dashboard chỉ trong 1 cú nhấp chuột.

Thao tác nhanh

Tài liệu phát hành theo chuẩn OpenBanking 2.0 · Cập nhật v1.0.5 (Chính thức)Góp ý tài liệu & Báo lỗi ↗