[控场AI]
概念HTTP Status Code

HTTP状态码

HTTP协议中用于表示服务器对请求处理结果的三位数字代码,2xx表示成功、4xx表示客户端错误、5xx表示服务端错误

核心事实

时间轴 (近 90 天)

10月18日

在验证API端点时,401表示Key错误或已吊销或缺少Bearer前缀,402表示账户余额或账单问题,403表示环境或权限不匹配,400/404(针对模型)表示Model ID已过期,429/5xx是唯二值得重试的状态码。

待验证50%
10月17日

遇到不可重试的状态码(如400、401、404)时,应直接break进入下一个模型,因为重试无意义。

待验证50%
10月14日

应重试的 HTTP 状态码包括:429、502、503、504,以及连接重置、超时等网络层故障。

待验证50%
10月14日

HTTP状态码中,2开头表示成功(200成功,201创建成功,204成功但无响应内容),3开头表示重定向或缓存(301和302重定向,304缓存),4开头表示客户端错误(401未提供鉴权,403无权限,422参数格式不正确,429请求过于频繁),5开头表示服务器内部错误。

待验证50%
10月14日

传统API返回的裸错误码(如404、500)会使Agent陷入无效重试循环,因为Agent缺少人类开发者查阅日志和文档的上下文能力

待验证50%
10月14日

HTTP状态码200表示页面正常返回;301/302表示重定向,过长链条会稀释权重;404表示页面不存在;410表示内容永久移除;5xx表示服务器错误。

待验证50%
10月13日

HTTP 200状态码表示服务端已接受并开始运行任务,但不承诺处理结果正确;200以外的状态码意味着任务没有启动。

待验证50%
10月11日

一旦响应以200状态码开始就无法再更改状态码,因此应把异常封装成显式的error事件发给前端

待验证50%
10月11日

404在模型调用场景中通常意味着模型ID不存在或已下线,属于可尝试其他模型的信号

待验证50%
9月12日

HTTP 503表示服务器暂时无法处理请求,500表示后端逻辑异常,404表示请求的资源不存在

待验证50%

还有 1 条时间轴事件

全部知识事实 (12)

已验证

HTTP 200状态码仅表示服务器成功接收并处理了请求,不代表业务逻辑正确执行,大量业务错误会被包裹在200响应体内

70%
待验证

在验证API端点时,401表示Key错误或已吊销或缺少Bearer前缀,402表示账户余额或账单问题,403表示环境或权限不匹配,400/404(针对模型)表示Model ID已过期,429/5xx是唯二值得重试的状态码。

50%
待验证

遇到不可重试的状态码(如400、401、404)时,应直接break进入下一个模型,因为重试无意义。

50%
待验证

应重试的 HTTP 状态码包括:429、502、503、504,以及连接重置、超时等网络层故障。

50%
待验证

HTTP状态码中,2开头表示成功(200成功,201创建成功,204成功但无响应内容),3开头表示重定向或缓存(301和302重定向,304缓存),4开头表示客户端错误(401未提供鉴权,403无权限,422参数格式不正确,429请求过于频繁),5开头表示服务器内部错误。

50%
待验证

传统API返回的裸错误码(如404、500)会使Agent陷入无效重试循环,因为Agent缺少人类开发者查阅日志和文档的上下文能力

50%
待验证

HTTP状态码200表示页面正常返回;301/302表示重定向,过长链条会稀释权重;404表示页面不存在;410表示内容永久移除;5xx表示服务器错误。

50%
待验证

HTTP 200状态码表示服务端已接受并开始运行任务,但不承诺处理结果正确;200以外的状态码意味着任务没有启动。

50%
待验证

一旦响应以200状态码开始就无法再更改状态码,因此应把异常封装成显式的error事件发给前端

50%
待验证

404在模型调用场景中通常意味着模型ID不存在或已下线,属于可尝试其他模型的信号

50%
待验证

HTTP 503表示服务器暂时无法处理请求,500表示后端逻辑异常,404表示请求的资源不存在

50%
待验证

接口自动化编排中,401表示认证失败、404表示资源不存在,AI可根据HTTP状态码智能诊断问题

50%

来源文章