响应格式

通用响应封装与错误处理指南

本文档说明合作伙伴服务器 API 的通用响应格式。

所有响应都用通用信封（envelope）包裹。

成功：

{"resultType": "SUCCESS", "success": { ... }}

失败：

{"resultType": "FAIL", "success": null, "error": {"errorType": 0, "errorCode": "4010", "reason": "...", "data": {}, "title": null}}

业务错误以 HTTP 200 返回。 请确认resultType是否为SUCCESS，并将所有不是SUCCESS的值都视为失败。请求格式错误（字段验证失败）返回 HTTP 400，未分类的服务器错误返回 HTTP 500。当超过请求限制时，会在 HTTP 200 中返回 errorCode: "4095" 和 error.data.retryAfterSeconds。