Häufige Fragen API

Diese Seite sammelt Fragen, die bei der Kopplung externer Systeme an die Jawengo API auftreten. Wenden Sie sich bei weiteren Fragen an Ihre interne Support-Stelle.

Warum wird meine Anfrage abgewiesen?

Symptom: Die Anfrage liefert den HTTP-Status 403 (Zugriff verweigert) statt Daten. Ursache: Der Header API_KEY fehlt, ist falsch geschrieben oder enthält einen unbekannten oder gesperrten Schlüssel. Der Server prüft nur diesen Header. Lösung: Prüfen Sie den Schlüssel im Benutzer unter Einstellungen ▸ Benutzer & Unternehmen ▸ Benutzer, Reiter API Keys, und ob die Spalte Active gesetzt ist. Testen Sie mit /api/ping. Siehe auch: Authentifizierung

Muss ich HTTPS verwenden?

Symptom: Sie sind unsicher, ob http genügt. Ursache: Der Schlüssel wird im Klartext im Header mitgeschickt; wer die Verbindung mitliest, kann ihn verwenden. Lösung: Verwenden Sie in jedem Fall https:// mit der Adresse Ihrer Jawengo-Website. Siehe auch: Authentifizierung

Gibt es eine Begrenzung der Anfragen pro Minute?

Symptom: Sie planen regelmässige Abfragen und fragen nach Limiten. Ursache: Es ist keine Begrenzung der Anfragen hinterlegt. Jede Anfrage belastet jedoch den Server. Lösung: Fragen Sie nur so oft ab, wie Ihre Anwendung es braucht, etwa einmal pro Zeitfenster bei der Belegung. Siehe auch: Belegungsdaten

Warum liefert die Belegung nur false?

Symptom: Die Abfrage der Belegung antwortet mit false. Ursache: Der Standort ist nicht für die Nutzung als Center oder für alle Zwecke freigegeben. Lösung: Prüfen Sie beim Standort die Verwendung und die Standortnummer in der Adresse. Siehe auch: Belegungsdaten

Warum enthält die Belegung keine Zeitfenster?

Symptom: Die Antwort zeigt den Standortstatus closed und eine leere Liste. Ursache: Für das angefragte Datum gibt es kein Zeitraster für den Standort. Lösung: Prüfen Sie Öffnungszeiten und Raster des Standorts für dieses Datum. Siehe auch: Belegungsdaten

Was bedeutet der Fehlercode bei einer Reservierung?

Symptom: Die Antwort enthält einen Fehler, obwohl der HTTP-Status 200 lautet. Ursache: Schreibende Aufrufe antworten immer mit Status 200; der Fehler steht im Feld result. Es gibt zwei Formen. Die erste enthält result mit ERROR, error_code und error: REQUIRED_VALUE_MISSING (Pflichtfeld fehlt), RESERVATION_NOT_FOUND (Reservierung unbekannt), UPDATE_NOT_ALLOWED (Datum, Zeit oder Platz lassen sich nicht ändern) und PITCH_NOT_AVAILABLE (kein Raster oder Preis für den Platz). Die zweite enthält nur error und message, ohne error_code: PITCH_NOT_FREE (Platz belegt) und RESERVATION_TIME_IN_PAST (Zeitpunkt vergangen). Lösung: Korrigieren Sie die Anfrage; zum Verschieben stornieren Sie die Reservierung und legen sie neu an. Werten Sie beide Formen aus. Siehe auch: Weitere Endpunkte

Warum meldet das Anlegen, Pflichtfelder fehlten?

Symptom: POST /api/reservation antwortet mit REQUIRED_VALUE_MISSING, obwohl Sie alle Felder senden. Ursache: Sie haben die Felder in einem JSON-RPC-Umschlag (jsonrpc, method, params) gesendet. Die API liest nur den flachen Körper. Lösung: Senden Sie {"date": "...", "time_from": 10.0, "time_to": 11.0, "pitch_id": 65} direkt, mit dem Header Content-Type: application/json. Die Antwort kommt trotzdem im JSON-RPC-Umschlag. Siehe auch: Weitere Endpunkte

Warum schlägt das Stornieren fehl?

Symptom: DELETE /api/reservation/<id> meldet einen Fehler oder wird nicht verarbeitet. Ursache: Es fehlt der JSON-Körper oder der Header Content-Type: application/json, oder der Benutzer der Kopplung hat keine E-Mail-Adresse. Lösung: Senden Sie -d '{}' mit dem Header und hinterlegen Sie beim Benutzer eine E-Mail-Adresse. Bei abgelaufener Stornofrist lautet die Antwort late_cancel statt cancel. Siehe auch: Authentifizierung

Tipp: Loggen Sie in Ihrem System den gesamten Antwortinhalt mit, nicht nur den Status der Anfrage.