连接器的完整性通过满足某些标准来得到保护。 其中一个标准是使用条件,其中包括成功率。 此值按照 100 秒、200 秒、300 秒、400 秒和 500 秒内 API 响应的百分比计算。 例如,100 包含 100 以上、200 以下的响应。 此计算不包括由于限制导致的失败。
以下是计算成功率的公式:
Success Rate = ((responseCode 100s + responseCode 200s + responseCode 300s - responseCode 400s - responseCode 500s) * (1/ all-responseCode-count)) * 100
错误代码
下表列出了用户和合作伙伴遇到的最常见错误及其说明。 其中包括 400 秒和 500 秒的错误代码。 不包括 100 秒、200 秒或 300 秒的错误代码,因为它们不太常见。 ISV Studio 门户中提供了错误代码。
为了帮助您快速有效地解决错误,请按照本文后面的建议操作。
错误代码 | Description |
---|---|
400 | 指示由于某些被认为是用户错误(错误请求)的原因,服务器无法或不会处理请求。 用户输入了一些无效输入。 |
401 | 指示身份验证流程失败。 这意味着在用户首次使用有效的身份验证凭据登录之前,无法加载用户尝试访问的页面。 |
403 | 当用户超过 API 提供的限制时。 |
404 | 用户在调用已弃用或不再存在的操作。 |
409 | 由于与目标资源的当前状态冲突,无法完成请求。 当用户可能能够解决冲突并重新提交请求时使用此代码。 |
415 | 指示请求实体具有服务器或资源不支持的媒体类型(不支持的媒体类型)。 如果服务器不支持请求正文的内容,则可能仍会返回响应代码。 |
426 | 指示服务器拒绝使用当前协议执行请求。 在客户端升级到不同协议(需要升级)之后,服务器可能会这样做。 |
429 | 超出速率限制(请求过多)。 超出 API 的速率限制。 |
500 | 指示服务器遇到意外情况,无法完成请求(内部服务器错误)。 |
502 | 指示托管 Web 服务器存在问题(服务器端错误)。 例如,基础连接被关闭:连接被服务器关闭。 |
504 | 指示服务器花费了很长时间以致“超时”,可能已关闭或无法正常工作。 当服务器无法及时获取响应时会出现此错误。 |
522 | 连接超时。 |
523 | 指示连接出现的问题。 |
524 | 指示与服务器的连接由于超时(发生超时)而关闭。 |
解决 400 错误
400 秒的错误代码指示由于请求出现问题导致发生系统错误。
更新连接器文档页面,以涵盖用户可能遇到的所有常见错误。
在已知问题和限制一节添加更多信息。 您可以使用 intro.md 文件添加这些常见错误和限制。
要指导您的用户取得成功,帮助他们减少错误,请将工具提示直接添加到 UI。 以下屏幕截图显示了工具提示的示例。
解决 500 错误
500 秒的错误代码指示由于服务器出现问题导致发生错误。
将 API 已知问题和限制添加到连接器的已知问题和限制一节。 您可以使用 intro.md 文件添加这些常见错误和限制。
确保 API 和托管 Web 服务器正常工作。
确保所有操作和触发器都使用正确的 http 或 https 请求和适当的响应。
详细信息
提供反馈
我们非常感谢大家提出有关连接器平台问题或新功能想法的反馈。 要提供反馈,请转到提交问题或获取连接器帮助,然后选择反馈类型。