在行云平台中，所有API响应均采用JSON格式，HTTP状态码统一返回200。业务层面的成功或失败状态通过响应JSON中的code字段进行区分。错误码分为两大类：全局错误码和业务错误码。
若您在请求API过程中收到HTTP状态码非200的响应，这通常表示网络传输或服务器层面出现异常，请联系技术支持处理。
全局错误码为三位整数，遵循HTTP状态码规范，具有全局一致性。开发过程中，建议针对全局错误码实现统一的拦截处理机制。
| 错误码 | 英文描述 | 中文含义 | 说明 |
|---|---|---|---|
200 |
Success | 请求成功 | 接口请求成功，正常返回数据 |
400 |
Invalid Request | 无效请求 | 请求参数有误或格式不正确，具体请参考msg值 |
401 |
Unauthorized | 未授权 | 未提供认证信息或认证信息无效 |
402 |
Token Expired | 令牌过期 | 认证令牌已过期，需要重新获取 |
403 |
Forbidden | 禁止访问 | 无权限访问该资源 |
404 |
Not Found | 接口不存在 | 请求的接口不存在 |
405 |
Method Not Allowed | 方法不允许 | 请求方法（GET/POST等）不支持 |
406 |
Not Acceptable | 不可接受 | 服务器无法根据请求提供符合要求的响应 |
413 |
Request Entity Too Large | 请求内容过大 | 上传文件或请求体超过允许的大小限制 |
429 |
Too Many Requests | 请求过于频繁 | 已超过API请求频率限制 |
500 |
Server Error | 服务器错误 | 服务器内部错误，请联系技术支持 |
业务错误码用于表示接口参数验证失败或业务逻辑异常。这类错误码统一采用400开头的6位数字格式。 业务错误码在不同接口间存在复用，但在同一接口中不会出现重复的错误码。开发时，应针对当前接口可能返回的错误码实现相应的错误处理逻辑。 各接口的具体错误码及其含义，请参考相应接口文档中的错误码说明部分。