接入
API
通过 REST 把 Yumi 经过验证的门店数据直接接入你的产品或后端：既能搜索与推荐，也能用同一把密钥发送订位请求和“现在能进吗？”这类实时问题。获取密钥 → 加到请求头 → 首次调用。
在仪表盘中签发你的 API 密钥。明文密钥只在创建时显示一次，请妥善保管。
获取 API 密钥 →- 01
创建密钥
在仪表盘中创建 API 密钥。明文密钥只显示一次。
- 02
发送密钥
在每个请求中加入 Authorization: Bearer <KEY>。（避免在 URL 中使用 ?api_key=，它容易被记入日志，且已废弃。）
- 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），所以花费很少。只有当你特意请求联系方式、评分、详情等更丰富的字段时，才会消耗更多。费用随所选字段而定，因此可预测。在 Open Season 期间，个人使用免费，每天最多 70 个 token。若需商用、大流量使用或更高配额，请联系我们。
商用 / 大流量？联系我们 →