SuperAPI AI 工具集

ship-hero

编程与开发

查看项目

更新于 10-16 08:44

技能介绍

用途:面向需要对接 ShipHero 电商履约系统的开发者,提供 GraphQL API 集成指导,涵盖订单、库存、发货、退货与采购单等管理场景。

主要能力:通过 GraphQL 端点 https://public-api.shiphero.com/graphql 执行查询与变更,支持创建订单(order_create)、添加库存(inventory_add)、注册 Webhook(webhook_create)等操作;支持 3PL 账户通过 customer_account_id 管理多客户,并可用 uuid 查询将旧整数 ID 转为 UUID。

认证:向 https://public-api.shiphero.com/auth/token 发送 POST 请求获取 JWT(有效期 28 天),请求头使用 Authorization: Bearer YOUR_ACCESS_TOKEN。

使用方式:查询需指定 first 或 last 参数,可用 analyze: true 预览查询成本;建议只请求必要字段并用 created_at_min、updated_at_min 过滤。响应包含 request_id、complexity 与 data,排错时应保留 request_id。

限制:初始 4,004 credits,恢复速率 60 credits/秒,单次操作上限 4,004 credits,硬性限制为每 5 分钟 7,000 次请求。常见错误码包括 3(参数无效)、5(未找到)、16(未认证)。

适用场景:电商订单与库存同步、发货与退货状态跟踪、Webhook 实时事件处理、3PL 多客户履约集成。

其他:资料提及 references/authentication.md、references/graphql-operations.md、references/webhooks.md 等参考文件,但未提供其具体内容;Python 客户端示例使用 gql 库。