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

常见错误码见 参数查询。