API 错误码大全
本文件列出 API 系统中的错误码及其含义，以便开发者快速查找和理解错误来源。
错误码表格
| 错误码 | HTTP 状态码 | 错误信息 | 描述 |
|---|---|---|---|
| 200 | 200 | 请求成功 | API 请求正常响应，返回成功的结果。 |
| 400 | 400 | 参数缺失或不合法 | 请求参数缺少或不符合预期要求，导致请求失败。 |
| 502 | 502 | 获取数据失败 | 外部 API 请求失败或无法获取数据，通常是服务器端问题。 |
| 500 | 500 | 服务器内部错误 | 服务器内部错误，可能是数据库故障、配置错误或其他服务器端问题。 |
| 503 | 503 | 服务维护中 | API 服务暂时不可用，通常是由于系统维护或过载导致的服务中断。 |
错误码详细说明
200 请求成功
- HTTP 状态码: 200
- 描述: 请求成功并且响应结果正常。API 返回预期的数据。
400 参数缺失或不合法
- HTTP 状态码: 400
- 描述: 请求参数缺少或者参数不符合预期要求。常见的场景如必填字段未提供，或者传入无效的参数格式。
401 未授权
- HTTP 状态码: 401
- 描述: 请求中未包含有效的授权信息，或者授权信息无效或过期。常见的原因包括缺少授权 token，或者提供了无效的用户凭证。
403 禁止访问
- HTTP 状态码: 403
- 描述: 当前用户没有足够权限访问请求的资源。可能是由于用户被禁止访问该资源，或者用户的权限级别不足。
404 资源未找到
- HTTP 状态码: 404
- 描述: 请求的资源在服务器上未找到。常见场景如 URL 拼写错误，或者请求的资源已经被删除或不存在。
502 获取数据失败
- HTTP 状态码: 502
- 描述: API 请求外部数据失败。常见的情况是访问外部接口时发生错误，或者目标服务器不可用。
500 服务器内部错误
- HTTP 状态码: 500
- 描述: 服务器发生内部错误，导致无法处理请求。这通常是因为服务器配置错误，或者出现了未处理的异常。
503 服务维护中
- HTTP 状态码: 503
- 描述: 服务暂时不可用，通常由于系统维护、过载、或其他临时性问题导致的服务中断。此时，开发者可以稍后重试请求。