API 約定與錯誤
Base URL
生產請求網關:
https://api.ucashier.ink測試請求網關:
https://api-beta.ucashier.ink開放介面使用 POST + application/json。完整 URL = 網關 + /api/public/...。
請求契約
- 字段名區分大小寫,類型按參數表的聲明傳遞。
- 每筆業務使用唯一
merchantOrderNo。 - 簽名原串由參數表中「簽名 = 是」的字段組成,算法為 HMAC-MD5(見簽名與驗簽)。
響應格式
所有介面的 HTTP 響應體為統一結構。code 為字符串 "100000" 表示成功,其它為失敗。
{
"code": "100000",
"message": "Success",
"data": { },
"requestId": "..."
}| 字段名稱 | 類型 | 說明 |
|---|---|---|
code | string | 請求狀態,"100000" 表示成功 |
message | string | 狀態描述 |
data | object | 業務資料,請求失敗時可能為空 |
requestId | string | 請求 id |
常見錯誤碼見 參數查詢。