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": "..."
}
字段名稱類型說明
codestring請求狀態,"100000" 表示成功
messagestring狀態描述
dataobject業務資料,請求失敗時可能為空
requestIdstring請求 id

常見錯誤碼見 參數查詢。