SuperAPI AI 工具集

mycarrierpackets-api

编程与开发

查看项目

更新于 10-15 21:47

技能介绍

用途:帮助在 TMS 等系统中集成 MyCarrierPackets(MCP)承运商数据 API,完成承运商入驻、数据查询、监控与文档获取。

主要能力:基础地址 https://api.mycarrierpackets.com,OAuth2 密码模式 Bearer Token,默认 JSON(Accept: text/xml 可返回 XML),Swagger 2.0,/api/v1/Carrier/* 下 23 个端点全部为 POST。覆盖承运商数据(PreviewCarrier、GetCarrierData、联系人、风险评估、事故、VIN、关联承运商反欺诈)、邀请与验证(EmailPacketInvitation、CompletedPackets、RequestUserVerification、RequestVINVerification)、监控(RequestMonitoring/CancelMonitoring、MonitoredCarriers、CarriersChanges 增量变更)、拉黑/解黑、文档下载(GetDocument)与保理公司列表。

使用方式:先 POST /token,Content-Type: application/x-www-form-urlencoded,grant_type=password&username={integration_username}&password={integration_password},返回 access_token 后每个请求带 Authorization: bearer <access_token>;凭据在 https://mycarrierpackets.com/IntegrationTools 管理。技能采用渐进式披露:先读 SKILL.md,再按需加载 references/endpoints/INDEX.md、TMS-INTEGRATION.md 或单个端点文件。典型流程:PreviewCarrier → EmailPacketInvitation → 轮询 CompletedPackets;RequestMonitoring → 轮询 CarriersChanges;GetCarrierData 取 blob 名 → GetDocument 下载 PDF。

限制与注意:分页在 X-Pagination 头(MonitoredCarriers 默认 2500/最大 5000,CarriersChanges 默认 250/最大 500),MonitoredCarrierData 分页在响应体;CarriersChanges 上游强制最小 4 分钟间隔,建议 5–15 分钟;VIN 验证仅 deliveryOption=2(电话)有效;州内承运商用 IntrastateNumber 并省略 DocketNumber;401 时清除缓存 token 重新认证,429 时增大轮询间隔。完整包 PDF API 使用 /api/token 而非主 /token。其余细节以官方参考文件为准。