Cấu hình

Config

Lớp Config (sealed class) là trung tâm cấu hình SDK. Tạo đối tượng Config với thông tin xác thực:

using SsiSdk;

var config = new Config("YOUR_CLIENT_ID")
{
    ApiKey = "YOUR_API_KEY",
    ApiSecret = "YOUR_API_SECRET",
    PrivateKey = "YOUR_PRIVATE_KEY",
};

Config có 2 constructor: Config() (rỗng, gán property sau) và Config(string clientId) (gán sẵn ClientId).

Tất cả tham số cấu hình

Mọi khoảng thời gian là số nguyên mili-giây (hậu tố Ms).

Property chỉ đọc, suy ra từ các tham số trên:

ToString() che thông tin nhạy cảm: ApiKey bị mask, ApiSecret và PrivateKey hiển thị ***. Dù vậy, vẫn không nên log Config.

Thay đổi so với bản cũ: TimeoutSeconds đã thành TimeoutMs, RetryDelay (giây, double) đã thành RetryDelayMs (mili-giây, int), và Config.DeviceId đã bị bỏ (SDK dùng mã máy của hệ điều hành làm deviceId khi gửi batch).

Retry và rate limit

• Chỉ request GET được retry. Với 429 trên GET, SDK tự chờ theo Retry-After, nếu không có thì chờ 1 giây rồi tăng gấp đôi, tối đa 3 lần retry và mỗi lần chờ tối đa 30 giây.
• POST, PUT, DELETE không bao giờ được gửi lại (đặt lệnh, huỷ lệnh, batch, FCO), vì lệnh lặp có thể bị tạo hai lần. Sau timeout, kết quả là không xác định: kiểm tra sổ lệnh trước khi gửi lại.
• RateLimitPerSecond là giới hạn phía client; thông tin rate limit của server nằm ở auth.RateLimit và trong RateLimitException.

TradingWsOptions

Tuỳ chọn cho TradingWs.ConnectAsync(auth, options) (namespace SsiSdk). Nếu không truyền thì dùng mặc định. Chi tiết hành vi xem Trading WebSocket.

Lưu ý: comment XML của RequestTimeoutMs trong mã nguồn SDK vẫn ghi "10000 when unset"; bảng trên phản ánh đúng theo code.

Cấu hình nâng cao

Debug logging

var config = new Config("YOUR_CLIENT_ID")
{
    ApiKey = "YOUR_API_KEY",
    ApiSecret = "YOUR_API_SECRET",
    LogLevel = "DEBUG",
};

Tuỳ chỉnh retry & rate limit

var config = new Config("YOUR_CLIENT_ID")
{
    ApiKey = "YOUR_API_KEY",
    ApiSecret = "YOUR_API_SECRET",
    MaxRetries = 3,
    RetryDelayMs = 1000,
    RateLimitPerSecond = 5,
};

Smart OTP và batch

var config = new Config("YOUR_CLIENT_ID")
{
    ApiKey = "YOUR_API_KEY",
    ApiSecret = "YOUR_API_SECRET",
    PrivateKey = "YOUR_PRIVATE_KEY",
    OtpPollIntervalMs = 3000,   // poll Smart OTP mỗi 3 giây
    OtpPollMaxWaitMs = 90000,   // chờ duyệt tối đa 90 giây
    MaxBatchOrders = 20,        // giới hạn số lệnh mỗi batch
};

API reference ghi giới hạn batch phía server là 50 lệnh mỗi request, trong khi mặc định của SDK là 20. Nâng MaxBatchOrders là quyết định của bên gọi: xem Lệnh hàng loạt.

Proxy

var config = new Config("YOUR_CLIENT_ID")
{
    ApiKey = "YOUR_API_KEY",
    ApiSecret = "YOUR_API_SECRET",
    Proxy = "http://proxy.example.com:8080",
};

Khuyến nghị

• Giữ thông tin khóa (ApiKey, ApiSecret, PrivateKey) trong biến môi trường hoặc secret manager (Azure Key Vault, AWS Secrets Manager, ...) — không hardcode hoặc commit vào Git.
• Thiếu ApiKey/ApiSecret sẽ làm luồng xác thực thất bại (AuthenticationException).
• Thiếu PrivateKey sẽ ảnh hưởng các nghiệp vụ ký lệnh giao dịch (REST và Trading WebSocket).
• Cấu hình RateLimitPerSecond phù hợp với chính sách hệ thống.
• Chỉ bật LogLevel = "DEBUG" trong môi trường phát triển.
• Đặt TimeoutMs, MaxRetries, RetryDelayMs phù hợp với tải thực tế.