API 调用失败故障排除
Last updated: June 19, 2026
本文将用于分享导致客户 API 失败的情况。大多数情况下,当联系 L2L 支持团队咨询失败的 API 调用时,通常会发现以下某种情况是罪魁祸首。欢迎随时联系我们,我们很乐意帮助您排查问题。
同样关键的是,您需要让自己的本地 IT 部门参与进来。客户本地网络或防火墙的更改可能会导致 API 调用失败,而此前这些调用一直运行正常。
当 API 调用失败时,通常是由于以下原因之一:
1. 客户站点内部的防火墙阻止了 API 调用
2. IP 地址发生了更改,或之前列入白名单的 IP 地址不再列入白名单
3. API 调用语法不正确。这种情况经常发生,通常是由于:
- 缺少必需参数
- 调用中使用了名称或描述,而实际需要的是 代码
- 调用超时,通常是因为尝试检索超过 2,000 条记录的数据
- 由于重复和/或极高的 API 流量,调用超时
防火墙会出于以下某种原因限制流量。请询问您的本地 IT 人员是否发生过以下任何情况:
- IP 地址发生更改
- 代理配置错误
- 许可证过期
- 防火墙策略发生更改
以下是需要提供给 L2L 支持团队的信息,以帮助我们更快地排查失败的 API 调用:
- 他们所使用的确切 API 调用
- 返回的结果或错误消息
- 此 API 调用之前是否成功运行过?
- 它是什么时候停止工作的?日期和时间也可以加快您的本地 IT 团队以及 L2L 支持团队的故障排除过程。
- 您是否联系过本地 IT 人员?
- 您的 IT 部门是否对列入白名单的 IP 地址进行了任何更改?