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 |
常见错误码见 参数查询。