SuperAPI AI 工具集

faire

编程与开发

查看项目

更新于 10-16 02:36

技能介绍

用途:面向 Faire 批发品牌运营的 External API V2 接口技能,适用于需要读取或更新商品、订单、库存、发货、装箱单及零售商数据的场景。当用户提及相关业务对象时可调用。

主要能力与用法:认证需先在 app.vm0.ai/connectors 连接 Faire 连接器,获取 FAIRE_TOKEN,所有请求通过请求头 X-FAIRE-ACCESS-TOKEN: $FAIRE_TOKEN 传递。基础 URL 为 https://www.faire.com/external-api/v2。订单方面可列出订单并支持 created_at_min、updated_at_min、ship_after_max、excluded_states、original_order_id 等过滤参数,也可按订单 ID 获取单个订单。商品方面可列出与获取单个商品。库存方面可按变体 ID 或 SKU 查询,并可通过 PATCH 按变体 ID 更新在手数量,更新请求体 JSON 需包含 inventories 数组(字段 product_variant_id 与 on_hand_quantity)。发货方面可列出某订单的发货信息。

排查与文档:请求失败可运行 zero doctor check-connector --env-name FAIRE_TOKEN 或 zero doctor check-connector --url "https://www.faire.com/external-api/v2/orders?limit=10" --method GET。官方文档见 https://faire.github.io/external-api-v2-docs/,支持见 https://www.faire.com/support/。

限制与注意:Faire API 访问通常限定于某个品牌账户,写入前应确认令牌属于正确品牌。批量同步任务应使用 page 和 limit 参数。库存写入可能影响商品可售性,更新前需确认 SKU 或变体 ID。零售商详情、运输标签、装箱单和结算数据应视为敏感业务数据。其他功能细节暂未提供。