Thông tin chung
Đăng ký dịch vụ
Để sử dụng dịch vụ FastConnect API, bạn cần đăng ký với SSI.
Tham khảo các bước đăng ký tại đây.
Tạo key kết nối
Để truy cập được các api và streaming hub, bạn sẽ cần có một bộ key kết nối cấp bởi SSI. Một bộ key bao gồm:
ConsumerID: Định danh tài khoản
ConsumerSecrect: Key truy cập server
PrivateKey: Được sử dụng để tạo chữ ký số bằng thuật toán RS256
Tham khảo hướng dẫn tạo key kết nối tại đây.
Lưu ý: Thông tin kết nối sử dụng dịch vụ là thông tin bảo mật và chỉ hiển thị một lần cho mình bạn khi tạo kết nối. Bạn cần lưu trữ bộ key kết nối một cách bảo mật. Không chia sẻ thông tin key kết nối cho bất kỳ ai.
Nếu bạn lỡ chia sẻ bộ key kết nối, hãy xóa ngay và lên trang Dịch vụ API tại iBoard để tạo lại bộ key mới.
Mẫu code (Client mẫu)
Để thuận lợi hơn cho khách hàng, SSI hỗ trợ ứng dụng kết nối mẫu viết bằng ngôn ngữ Python, Node.js và Java. Bạn có thể tải các client mẫu đó theo các đường dẫn dưới đây.
Python
FC Data
https://github.com/SSI-Securities-Corporation/python-fcdata/releases/latest/download/fc-data.py.zip
FC Trading
Node.js
FC Data
https://github.com/SSI-Securities-Corporation/node-fcdata/releases/latest/download/fc-data.zip
FC Trading
https://github.com/SSI-Securities-Corporation/node-fctrading/releases/latest/download/fc-trading.zip
Java
FC Data
https://github.com/SSI-Securities-Corporation/java-fcdata
FCTrading
https://github.com/SSI-Securities-Corporation/java-fctrading
.Net
FC Data
https://github.com/SSI-Securities-Corporation/dotnet-fcdata.git
FCTrading
https://github.com/SSI-Securities-Corporation/dotnet-fctrading.git
Xem hướng dẫn sử dụng client mẫu FC Data và hướng dẫn sử dụng client mẫu FC Trading để biết thêm chi tiết.
Giới hạn
Các api sẽ có giới hạn số lượng request gửi tới hệ thống (ratelimit). Nếu request của bạn gửi tới hệ thống vượt quá giới hạn này, bạn sẽ nhận được thông báo lỗi.
Đối với FC Trading, giới hạn được tính trên từng tài khoản
Đối với FC Data, giới hạn được tính tên từng key kết nối.
Khi số lượng request của bạn vượt quá giới hạn, hệ thống sẽ trả ra các thông báo lỗi sau:
Đối với API: "API calls quota exceeded! maximum admitted x per y s"
Đối với streaming: "Connection has been blocked, quota x exceeded by y"
Trường hợp bạn có nhu cầu giới hạn riêng, vui lòng liên hệ với môi giới quản lý tài khoản.
Để nhận được dữ liệu cập nhật tức thời, bạn nên dùng kết nối streaming, tránh bị tính ratelimit vì dùng api truy vấn thông tin cập nhật.
Kỳ hạn dịch vụ
Khi bạn đăng ký, dịch vụ sẽ có kỳ hạn là 1 năm kể từ ngày đăng ký. Nếu hết hạn, key của bạn sẽ không thể kết nối tới hệ thống. Thông báo lỗi sẽ có dạng: { message: 'The connection is invalid', status: 400, data: null }
Bạn cần thực hiện gia hạn để tiếp tục sử dụng dịch vụ. Tham khảo cách gia hạn dịch vụ tại đây.
SSI gửi mail nhắc gia hạn dịch vụ 7 ngày trước ngày hết hạn. Nếu quý khách không nhận được mail, vui lòng kiểm tra hòm mail rác.
Chữ ký điện tử
Signature là một chuỗi ký tự được tạo ra từ một thuật toán cho trước, sử dụng để kiểm tra tính đúng đắn của dữ liệu trên đường truyền giữa 2 hệ thống. Một số thuật toán đang sử dụng là MD5, SHA256, RSA. Tham khảo thêm: Wikipedia
Trong tài liệu này sử dụng thuật toán RSA + SHA256 để tạo Signature. Dữ liệu đầu vào bao gồm Secret Key và data, data là một json body chứa thông tin đặt/sửa/xóa.
Last updated