連携
API
製品やバックエンドから、REST でユミの検証済み店舗データをそのまま呼び出せます。検索・レコメンドはもちろん、予約リクエストや「今それ、できますか?」というリアルタイムの問い合わせまで、同じキーで。キーを発行 → ヘッダーにキー → 最初の呼び出しで完了です。
API キーはダッシュボードで発行します。平文のキーは作成時に一度だけ表示されるので、安全な場所に保管してください。
API キーを取得 →- 01
キーを発行
ダッシュボードで API キーを作成します。平文のキーは発行時に一度だけ表示されます。
- 02
ヘッダーにキーを入れる
すべてのリクエストに Authorization: Bearer <KEY> の一行を入れるだけです。(URL の ?api_key= はログに残りやすいため非推奨・廃止予定です)
- 03
最初の呼び出し
/api/v1/places で一度検索してみてください。呼び出しごとにトークンが正確に消費され、上限を超えると 429 を返します。
example
curl -H "Authorization: Bearer YOUR_KEY" \ "https://api.heyyumi.ai/api/v1/places?keyword=burger&min_confidence=0.7"
呼び出すとどれくらい使う?
受け取りたいフィールドを選んだ分だけトークンが消費されます。基本(core)は軽いので消費が少なく、連絡先・評価・詳細のような豊富なフィールドをあえてリクエストしたときだけ少し多く使います。選んだフィールドに応じて費用が決まるので、予測できます。Open Season の間は個人利用が無料で、1 日あたり 70 トークンまで試せます。商用・大量利用や、より大きな上限が必要な場合はお問い合わせください。
商用・大量利用のお問い合わせ →