Se connecter
REST API
Récupérez les données d'établissements en REST depuis le serveur de votre service. La même clé permet aussi d'envoyer des demandes de réservation et des questions en temps réel comme « C'est possible maintenant ? ». Trois étapes suffisent pour obtenir une première réponse.
La clé d'API se crée dans le tableau de bord. Elle n'est affichée en clair qu'une fois, à la création : gardez-la en lieu sûr.
Obtenir une clé d'API →- 01
Créer une clé
Créez une clé d'API dans le tableau de bord. Elle n'est affichée en clair qu'une fois, à la création.
- 02
Mettre la clé dans l'en-tête
Ajoutez l'en-tête Authorization: Bearer <KEY> à chaque requête. Passer la clé dans l'URL avec ?api_key= sera bientôt bloqué, car elle finit facilement dans les journaux du serveur.
- 03
Premier appel
Lancez une recherche sur /api/v1/places. Chaque appel consomme des tokens. Au-delà de votre quota, vous recevez une 429.
example
curl -H "Authorization: Bearer YOUR_KEY" \ "https://api.heyyumi.ai/api/v1/places?keyword=burger&min_confidence=0.7"
Combien de tokens consomme un appel ?
Cela dépend des champs choisis. Le niveau de base (core) coûte 1 token. Si vous demandez aussi les contacts, les horaires ou les informations détaillées, l'appel en consomme davantage. Les champs demandés suffisent pour savoir à l'avance combien un appel coûtera. Chaque compte a 50 000 tokens gratuits par mois, et vous ne payez que ce qui dépasse. Pour de gros volumes ou un contrat annuel, contactez-nous.
Gros volumes : contactez-nous →