在线系统订单绩效对接
批量上传订单信息
批量上传企业订单信息,请求体为使用应用密钥 AES 加密后的订单 JSON 数组。解密后每条订单需包含 orderId(1-255 字符)、uid(1-128 字符)、payTime(>0),可选字段:status(0-4)、orderTime、amount、price、refundNo、refundTime。单次最多上传 1000 条。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| appKey | string | 是 | 应用 AppKey | |
| time | int64 | 是 | 请求时间戳(秒) | |
| checksum | string | 是 | 请求签名校验和 | |
| checksumAlgorithm | int32 | 否 | 签名算法:0 - 默认(SHA1),1 - SHA256 | |
| shopId | string | 否 | 平台店铺 ID(仅平台企业需传) |
请求体
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| encryptedData | string | 否 | AES 加密后的订单列表,解密后为 OrderItem 数组 | [{"orderId":"ORD001","uid":"user123","payTime":1700000000,"status":1}] |
返回参数
| 名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| code | int32 | 状态码,200 表示成功 | 200 |
| message | string | 响应消息,成功时格式为 "upload order info success, total = N" | upload order info success, total = 10 |
错误码
| 状态码 | 描述 |
|---|---|
| 14001 | AppKey 不存在 |
| 14002 | checksum 校验失败 |
| 14003 | 请求时间戳与服务器时间误差超过 10 分钟 |
| 14004 | 请求体 JSON 格式错误;订单参数缺失或格式错误;超过单次上传上限 |
| 14300 | 请求体 AES 解密失败(应用密钥变更或加密格式错误) |
| 14301 | shopId 无效 |
| 14500 | 服务内部异常;无权限;系统繁忙 |
postEndpoint
/openapi/order/uploadcurl -X POST "https://qiyukf.com/openapi/order/upload?appKey=string&time=0&checksum=string" \ -H "Content-Type: application/json" \ -d '{}'{
"code": 200,
"message": "upload order info success, total = 10"
}{
"code": 14001,
"message": "AppKey 不存在"
}{
"code": 14002,
"message": "checksum 校验失败"
}{
"code": 14003,
"message": "请求时间戳与服务器时间误差超过 10 分钟"
}{
"code": 14004,
"message": "请求体 JSON 格式错误;订单参数缺失或格式错误;超过单次上传上限"
}{
"code": 14300,
"message": "请求体 AES 解密失败(应用密钥变更或加密格式错误)"
}{
"code": 14301,
"message": "shopId 无效"
}{
"code": 14500,
"message": "服务内部异常;无权限;系统繁忙"
}这篇文档有帮助吗?