通用请求参数与响应
请求参数
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| PartnerId | String | 是 | 审核通过后获得的身份ID 服务商模式不要传这个参数 |
| ServiceProviderId | String | 否 | 仅服务商模式有效 服务商ID 服务商入驻流程 |
| OpenID | String | 否 | 仅服务商模式有效 已绑定授权用户OpenID |
| Timestamp | String | 是 | 时间戳，是指格林威治时间1970年01月01日00时00分00秒（北京时间1970年01月01日08时00分00秒）起至现在的总秒数 |
| Sign | String | 是 | API输入参数签名结果 |
请求示例
{
"PartnerId": "123456",
"Timestamp": "1706758966",
"Sign": "GgXAWmcFWIANiJFRDy6GF+1MruDZPgoA2FRZAlLn9wHy8guc5dBm8tW/080kY4LzTCyu9puLRVol+eWJuYPCLtTTmcdj/0OY0U9dNyL4S2M1B5fhzezyCtT/CE5/5icNkQ8YFh3z8Z+RXeFg4qHyuQ/pUhgSJMDrNguJOm1on42FhEDDu7rcmwQnn4mvSDQKUc6t+Sc/q+hnqv1++YbkA8olsIv6f8a2xYQDGkSve0Y37HnjZx2DOpyMuWGrxSQmkhNee0VMXf8lFclVtivL0o326w2yssSYy5P6/q8Arn+TqZveP/9w/sohFTpf0WS4O7zz+5o8ImPTA6NJ78qmVQ=="
}返回结果通用说明
| 参数 | 类型 | 说明 |
|---|---|---|
| ResultCode | Integer | 状态码。 |
| ResultMsg | String | 响应状态描述。 |
| ResultData | String | 响应信息，具体内容请参照各接口详细说明。 |
ResultCode状态码说明
| 数值 | 说明 |
|---|---|
| 0 | 操作成功 |
| -1 | 系统异常 |
| 1 | 操作失败 |
| 2001 | 请求参数错误 |
| 2002 | 请求参数为空 |
| 3001 | 记录重复 |
| 3002 | 记录不存在 |
| 4004 | 不在IP白名单 |
| 5001 | 用户公钥未设置 |
| 5002 | 非法的时间戳参数 |
| 5003 | 时间戳已失效 |
| 5004 | 验签失败 |
| 5005 | 身份ID无效 |
| 5006 | api调用权限被封禁 |
| 5007 | 时间戳错误 |
| 5008 | 服务商ID无效 |
| 6001 | 接口请求频次过快,请稍后重试 |
| 6002 | 此接口暂时关闭 |
| 6003 | 接口无权限访问 |
| 6004 | 服务商权限未开通 |
| 6005 | 用户与服务商未进行授权绑定 |
| 7001 | 时间格式错误 正确格式为yyyy-MM-dd HH:mm:ss 例如2024-12-10 13:16:21,可以不带时分秒 |
| 7002 | 查询时间超出限制 |
| 7003 | 查询数量超出最大限制 |
| 7004 | 游戏维护 |
| 7005 | 商品不可购买 |
| 7006 | 余额不足 |
| 7007 | SteamID限制交易 |
| 7008 | 商户号重复 |
| 7009 | 商品价格变化 |
购买接口失败时可能出现的ResultMsg说明
| ResultCode | ResultMsg |
|---|---|
| 1 | 余额不足,请充值或者使用其他支付方式 |
| 1 | 交易链接已失效 |
| 1 | steam账户不可交易 |
| 1 | 用户多次未接受报价，限制交易。截至到{yyyy-MM-dd HH:mm:ss} |
| 1 | Steam登录状态已失效 |
| 1 | 用户未开通购买权限,请前往开放平台设置 |
| 7005 | 您不能购买自己的商品 |
| 7006 | 用户余额不足 (仅限P2P购买) |
| 7007 | SteamID限制交易 (仅限P2P购买) |
| 7008 | 商户号重复 |
| 7009 | 商品价格发生变化，不可购买 |
订单取消时可能出现的CancelReason说明
| CancelType | Text |
|---|---|
| 101 | 未支付取消 |
| 102 | 系统取消 |
| 201 | 报价被取消 |
| 202 | 报价被拒绝 |
| 203 | 报价被修改 |
| 204 | 超时未发送报价 |
| 205 | 超时未接受报价 |
| 206 | 账户异常 |
| 207 | 商品下架 |
| 208 | 资产失效 |
| 209 | 买家账号不可交易 |
| 210 | 卖家账号不可交易 |
| 211 | 买家交易链接失效 |
| 212 | 卖家交易链接失效 |
| 213 | 买家交易暂挂风险 |
| 214 | 卖家交易暂挂风险 |
| 215 | 超时未支付尾款 |
| 216 | 饰品已被买断 |
| 217 | 买家超时未签订合同 |
| 301 | 买家取消订单 |
| 302 | 卖家取消订单 |
| 303 | 卖家无责取消订单 |
返回示例
{
"ResultCode": "0",
"ResultMsg": "成功",
"ResultData": {
}
}修改于 2025-07-22 07:12:39