4casters 訂單 API - 4casters API

4casters 訂單 API 透過原始 WebSocket 連線支援即時下單、取消和會話管理。

端點

訂單 API：wss://orders-api.4casters.io/orders/ws

認證

連線使用 4Casters 令牌進行認證。在 WebSocket 握手時於 Authorization 請求標頭中傳送令牌。伺服器從令牌推導使用者 — URL 中無需使用者名稱。

獲取令牌

沒有單獨的 API 金鑰。使用你的 4Casters 使用者名稱和密碼，呼叫 4Casters REST API 的 /user/login 端點登入。回應中包含可在此處使用的令牌。令牌有效期與輪換見認證。見 4Casters REST API 文件中的 POST /user/login。

連線

const WebSocket = require('ws');
const token = process.env.FOURCASTERS_TOKEN;
const ws = new WebSocket('wss://orders-api.4casters.io/orders/ws', {
  headers: { Authorization: token },
});

訊息格式

每個用戶端請求都是二元組 [messageType, payload]。每個酬載都應包含你生成的 requestID；伺服器會原樣回傳，以便你關聯回應。

[
  "messageType",
  {
    "requestID": "YOUR_REQUEST_ID",
    "...": "..."
  }
]

伺服器回應是帶有 requestID 以及 data（成功）或 error（失敗）的 JSON 物件：

{
  "requestID": "YOUR_REQUEST_ID",
  "data": { "...": "..." }
}

{
  "requestID": "YOUR_REQUEST_ID",
  "error": "human-readable error"
}