规则说明

请求参数

• GET 请求： 参数在 URL 上，参数的值需要经过 urlencode 处理。
• POST 请求：参数在 body 中以 Raw JSON 形式上报。
• 文件上传请求：参数在 body 中以 Form Data 形式上报。

API KEY

由系统分配，用于标识商户，在签名中使用。

请求 ID

系统给每个接收到的请求分配了一个唯一标识。请求的唯一标识包含在应答的响应体中 requestId 中。当需要帮助时，请提供请求的唯一标识，以便我们更快的定位到具体的请求。

错误信息

请求成功统一 HTTP 状态码为 200，成功处理的响应体中 code 也为 200，其它 code 码为业务处理失败/异常，失败原因会在 message 响应字段进行描述。

请求处理时发生了服务系统错误，将返回 500、501、503 的状态码。这种情况比较少见。

User Agent

HTTP 协议要求发起请求的客户端在每一次请求中都使用 HTTP 头 User-Agent 来标识自己。系统会拒绝处理无 User-Agent 的请求。

IP 白名单

在生产环境中如果商户配置了 IP 白名单，系统会强制验证请求客户端的 IP 是否在白名单内，系统会拦截不在白名单中的请求。

测试环境上无 IP 限制。