提高连接器的完整性

连接器的完整性通过满足某些标准来得到保护。 其中一个标准是使用条件,其中包括成功率。 此值按照 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 请求和适当的响应。

详细信息

提供反馈

我们非常感谢大家提出有关连接器平台问题或新功能想法的反馈。 要提供反馈,请转到提交问题或获取连接器帮助,然后选择反馈类型。