SuperAPI AI 工具集

flexport-common-errors

部署与运维

查看项目

更新于 10-15 23:25

技能介绍

用途:该技能用于 Flexport 接口排障,把失败先归类再决定动作,避免把所有错误都当成可重试问题。

主要能力:按表面区分 OAuth 令牌、REST v3、MCP JSON-RPC、Webhook 投递;保护证据时记录时间戳、凭据别名、版本头、操作摘要、状态/代码/消息与供应商关联元数据,但不含载荷和密钥;确定性分类 401 认证、403 权限/范围、404 资源或路由、400/422 校验、限流迹象、5xx 或传输不确定性。

使用方式:先识别表面与操作类别,再判断是否可能变更货运或贸易记录。仅对瞬态且幂等的工作做有界退避重试;创建或订舱在先前结果核对清楚前不得重试。认证上,REST 使用 audience 为 https://api.flexport.com 的 OAuth 2.0 客户端凭据缓存 Bearer 令牌,MCP 使用 https://mcp.flexport.com/mcp 的已认证连接,并受各工具账户权限约束。按所有者分派:凭据问题给凭据负责人,模式问题给集成负责人,业务校验给数据负责人,供应商事故给支持。

适用场景:状态码/消息错误分诊、权限失败、Webhook 与 MCP 调用异常,以及变更后超时需要核对结果的场景。

限制:资料未提供具体价格、平台支持范围与效果数据;不应用于未批准的 Flexport 侧变更,输出中不得包含凭据或供应商载荷。