错误处理
更新时间：2025-12-17
常见错误码
对话接口错误码:
| 错误码 | 描述 | 解决方案 |
|---|---|---|
| 400 | 请求参数错误 | 检查必填参数是否完整 |
| 401 | 认证失败 | 重新获取访问凭证 |
| 429 | 请求频率超限 | 降低请求频率 |
| 500 | 服务器内部错误 | 稍后重试或联系技术支持 |
会话信息接口错误码:
| HTTP状态码 | 错误信息 | 说明 | 解决方案 |
|---|---|---|---|
| 401 | Unauthorized | API Key无效或已过期 | 检查API Key是否正确，是否已过期 |
| 400 | Bad Request | 请求参数错误 | 检查请求参数格式和必填字段 |
| 400 | 员工不存在 | 员工ID不存在 | 确认员工ID是否正确 |
| 400 | 租户ID不匹配 | 员工不属于当前租户 | 检查API Key对应的租户权限 |
| 429 | Too Many Requests | 请求频率过高 | 降低请求频率，增加重试间隔 |
| 500 | Internal Server Error | 服务器内部错误 | 联系技术支持 |
错误响应格式
对话接口错误响应:
Plain Text
1{
2 "code": "employee-console_error",
3 "message": "员工ID不能为空",
4 "data": null
5}会话信息接口错误响应:
Plain Text
1{
2 "code": 401001,
3 "msg": "API Key验证失败",
4 "requestId": "req_123456789abcdef"
5}