连接

REST API

从你的服务器通过 REST 获取门店数据。同一个密钥还能发送预订请求,以及“现在可以吗?”这类实时询问。按下面三步,就能拿到第一个响应。

API 密钥在控制台创建。密钥原文只在创建时显示一次,请妥善保管。

获取 API 密钥 →
  1. 01

    创建密钥

    在控制台创建 API 密钥。密钥原文只在创建时显示一次。

  2. 02

    把密钥放进请求头

    每个请求都加上 Authorization: Bearer <KEY> 请求头。在 URL 后加 ?api_key= 的方式容易让密钥留在服务器日志里,即将停用。

  3. 03

    首次调用

    用 /api/v1/places 搜索试试。每次调用都会扣 token,超出限额时返回 429。

example

curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.heyyumi.ai/api/v1/places?keyword=burger&min_confidence=0.7"

调用一次扣多少 token?

由你选的字段决定。默认的 core 是 1 个 token,同时请求联系方式、营业时间或详细信息时会扣得更多。看字段就能提前知道会扣多少。每个账户每月免费 50,000 个 token,超出多少付多少。大量使用或年度合同请联系我们。

大量使用咨询 →