避免工作日灾难：11种常见API错误及其解决方案

你是否曾经感觉到，每当你试图取得进展时，计算机系统就会出现问题？ 如果您最近一直在使用应用程序接口（API），那么您可能会遇到一些常见错误。

这些错误信息可能会让人抓耳挠腮，但不用担心！ 我们将帮助您分析一些更常见的错误，以及如何以最佳方式解决它们，这样您就不会每天都头疼不已了。

本文将列出11个经常出现的 API 错误，以及如何排除它们。让我们开始吧！

HTTP STATUS CODE概述

在深入了解具体错误之前，我们先来了解一下 HTTP 状态代码。 HTTP 状态代码是 API 错误的主要指标。 它们是服务器让你知道它对你的请求有何看法的方式。

如果状态代码在 200 和 299 之间（包括 200 和 299），则表示 API 调用成功。 但如果出现错误，则会得到 4xx 或 5xx 状态代码。

4xx 状态代码 – 客户端错误： 客户端（您，API 用户）发送了一个请求，但服务器无法正确处理。

5xx 状态代码 – 服务器错误： 服务器遇到意外情况，无法满足请求。

在很多情况下，这些错误都可以根据提供的故障排除提示来解决。

11种常见API错误及其故障排除

既然我们已经掌握了基础知识，那么让我们来看看一些更常见的 API 错误。

400 Bad Request Error

该错误是最常遇到的 API 错误之一，它发生在服务器无法解析请求本身的情况下。 造成这种情况的原因可能是 URL 不正确、API 请求的组成方式有问题，甚至是应用程序本身的问题。

要排除此问题，首先要检查 URL，确保其看起来正确无误。 然后，检查 API 请求的语法，确保一切格式正确。 如果这还不能解决问题，您应该回到应用程序中查找任何明显的错误。

401 Unauthorized Error

当服务器无法授权用户凭据时，会出现此 API 错误。 造成这种情况的原因可能是用户名或密码不正确，甚至是缺乏权限访问。

要排除此 API 错误，首先要确认用户名和密码是否正确。 如果用户名和密码正确，但仍出现错误，则可能是权限问题；如果是这样，请联系 API 提供商寻求进一步帮助。

403 Forbidden Error

当服务器因授权问题或 API 提供商设置的其他限制而拒绝满足客户端的请求时，就会发生这种 API 错误。

要排除此 API 错误，请确保您有足够的权限在相关 API 端点上发出请求。 然后，查看 API 文档，确保在请求中发送了有效的数据参数。 最后，验证是否存在可能阻止访问相关 API 端点的外部限制。

404 Not Found Error

当服务器无法从 API 提供商处找到所请求的资源时，就会发生这种 API 错误。 造成这种情况的原因可能是 URL 不正确或 API 请求的组成方式有问题。

要排除此 API 错误，首先要验证 URL 是否正确。 同样重要的是查看 API 文档，确保您在请求中使用了正确的数据参数。 最后，如果其他方法都不奏效，请联系 API 提供商寻求进一步帮助。

408 Request Timeout Error

如果服务器在指定时间内未收到客户端的响应，且连接已终止，则会出现此 API 错误。

要排除此 API 错误，请仔细检查 URI 是否正确、检查互联网连接、重新加载页面或检查网络服务器的超时设置。

500 Internal Server Error

当服务器遇到意外情况而无法满足 API 请求时，就会发生这种 API 错误。 造成这种情况的原因可能是 API 提供商的内部系统出了问题，也可能是 API 请求的组成方式出了问题。

要排除此 API 错误，请查看 API 文档，确保您在请求中发送了有效的数据参数。 然后，联系您的 API 提供商，以获得进一步帮助，解决其内部系统中的任何潜在问题。

502 Bad Gateway Error

当服务器作为代理从另一个上游服务器接收到无效响应时，就会出现此 API 错误。 造成这种情况的原因可能是域名没有解析到正确的 IP、服务器无法访问或火线阻止了通信。

要排除此 API 错误，请检查您的域名，验证服务器是否可连接，或检查防火墙日志。

504 Gateway Timeout Error

当服务器作为代理在指定时间内未收到上游另一台服务器的响应时，就会发生此 API 错误。 造成这种情况的原因可能是网络连接问题或 API 请求的组成方式有问题。

要排除此 API 错误，首先要验证互联网连接是否正常，然后查看 API 文档，确保您在请求中发送了有效的数据参数。

505 HTTP Version Not Supported Error

当服务器不支持客户端请求的 HTTP 协议版本时，就会出现此 API 错误。

要排除此 API 错误，请确认您使用的是受支持的 HTTP 协议版本（通常为 1.1）。 然后，联系您的 API 提供商，以获得进一步帮助，解决其内部系统中的任何潜在问题。

507 Insufficient Storage Error

当服务器上没有足够的可用存储空间来满足 API 请求时，就会发生此 API 错误。

要解决此 API 错误，您可以提高标准托管套餐，或者在页面流量过大的情况下尝试优化软件仓库。

508 Loop Detected Error

当服务器识别到一个无限循环（API 请求的循环）时，就会出现此 API 错误。 这可能是由于链中重定向过多，导致请求的资源或 URL 无法呈现。

要排除此 API 错误，请尝试确定是哪些 API 调用导致了循环，然后联系您的 API 提供商，以获得更多帮助，解决任何潜在问题。

总结应用程序接口常见错误

API 错误可能由多种因素造成，从服务器级问题到不正确的 API 请求，不一而足。 了解最常见的 API 错误以及如何识别它们以排除故障非常重要。

此外，在尝试排除 API 错误之前，最好先确保您的互联网连接正常，因为这可能会影响某些 API 请求的结果。 最后，定期监控 API 的性能也很重要，以便及早发现 API 错误并减轻其对用户的影响。

如果 API 错误处理得当，就可以在对 API 客户造成最小干扰的情况下快速解决。 通过本指南，您应该能更好地了解最常见的 API 错误以及如何识别和排除这些错误。

本文翻译源自：https://blog.hubspot.com/website/api-errors