Verbinden
REST API
Du rufst die Daten zu Lokalen per REST von deinem eigenen Server ab. Mit demselben Schlüssel schickst du auch Reservierungsanfragen und Live-Anfragen wie 'Geht das gerade?'. Nach den drei Schritten unten hast du die erste Antwort.
Den API-Schlüssel erstellst du im Dashboard. Du siehst ihn nur einmal beim Erstellen, also bewahr ihn sicher auf.
API-Schlüssel holen →- 01
Schlüssel erstellen
Erstelle im Dashboard einen API-Schlüssel. Er wird nur beim Erstellen einmal angezeigt.
- 02
Schlüssel in den Header
Schick bei jeder Anfrage den Header Authorization: Bearer <KEY> mit. ?api_key= in der URL schalten wir bald ab, weil der Schlüssel so leicht in Server-Logs landet.
- 03
Erster Aufruf
Probier eine Suche über /api/v1/places. Jeder Aufruf kostet Tokens. Überschreitest du ein Limit, kommt 429 zurück.
example
curl -H "Authorization: Bearer YOUR_KEY" \ "https://api.heyyumi.ai/api/v1/places?keyword=burger&min_confidence=0.7"
Wie viele Tokens kostet ein Aufruf?
Das hängt von den Feldern ab, die du wählst. Die Grundstufe (core) kostet 1 Token. Nimmst du Kontakt, Öffnungszeiten oder Details dazu, wird es mehr. An den Feldern siehst du also vorher, was ein Aufruf kostet. Jedes Konto bekommt jeden Monat 50.000 Tokens kostenlos, du zahlst nur, was darüber hinausgeht. Für große Mengen oder einen Jahresvertrag melde dich bei uns.
Anfrage für große Mengen →