早期接入

合作伙伴 API

面向点餐、POS 和订位平台，帮助您把旗下餐厅接入客腾引。您的系统只需一次调用即可接入一家门店，之后即可读取该门店的博主探店预约和已发布的视频。合作伙伴 API 目前处于早期接入阶段：需申请开通，申请获批后我们会为您签发 API Key。

查看文档

经营餐厅？营销活动由客腾引替您运营。查看价格。

API 能做什么

接入门店、管理门店，并随时掌握每家门店的进展。

  • 接入与管理门店

    用您自己的门店 ID、门店名称和地址即可接入一家门店。之后可以修改门店信息，或暂停、恢复、终止合作。同一接入请求重复发送也不会出错：返回的仍是同一家门店。

  • 营业时间，我们代为查找

    您可以提供门店的营业时间，也可以留空由我们查找。查不到营业时间的门店会暂缓处理，直到营业时间确认为止。

  • 博主探店预约

    读取单家门店或您全部门店的每一条预约：预约状态、按门店时区显示的到店时间、到店人数，以及博主的账号、所在平台和粉丝数。接口不返回任何顾客或博主的联系方式。

  • 已发布的视频

    读取博主为每家门店发布的视频：链接、平台和发布时间。播放量和点赞数即将上线。

从门店接入到视频发布

一家测试门店在沙盒环境中的调用示例，从门店接入到视频发布。旁边是读取内容接口返回的 JSON。
一家测试门店的沙盒调用示例。一次调用接入门店，读取接口返回每个预约和视频。图中为示例数据。

  1. 接入门店

    调用 POST /locations，传入您的门店 ID、名称和地址。

  2. 完成设置

    如果您没有提供营业时间，我们会代为查找。营业时间未知的门店会暂缓处理。

  3. 从博主网络中邀约博主

    我们的团队会从 30万+ 博主网络中邀约博主。

  4. 预约探店

    博主选择日期和时间，预约随即确认。

  5. 到店探店

    预约最终标记为 completed（已完成）或 no_show（未到店）。

  6. 发布视频

    视频会出现在 GET /locations/{partner_location_id}/content 中。

  7. 读取结果

    预约、视频、/summary 汇总和月度统计，随时都能读取。

简单集成

以 Bearer Token 方式发送 API Key，请求与响应均为 JSON。

  • 统一的基础路径 /partner/v1，请求与响应均为 JSON
  • 错误格式为 { "error": { "code", "message" } }，并使用标准 HTTP 状态码
  • 每个 Key 默认每分钟 600 次请求，响应附带 RateLimit 响应头，429 响应附带 Retry-After 响应头
查看完整文档
curl -X POST "$CREATORAIN_API_BASE/locations" \
  -H "Authorization: Bearer $CREATORAIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "partner_location_id": "store_123",
    "name": "Example Noodle House",
    "address": {
      "line1": "100 Main St",
      "city": "San Jose",
      "state": "CA",
      "postal_code": "95113",
      "country": "US"
    }
  }'

准备好接入您的平台了吗？

预约出海咨询，与我们团队沟通，申请接入。