Häufige Probleme und Lösungen
Authentifizierungsfehler
401 Unauthorized
Problem:
Die API lehnt den Zugriff mit dem Fehlercode
401 Unauthorizedab.
Ursachen:
Fehlendes oder ungültiges OAuth2-Token.
Das Token wurde abgelaufen.
local.ch-ID noch nicht verknüpft.
Lösung:
Stellen Sie sicher, dass ein gültiges Token generiert und im Header übergeben wird:
Authorization: Bearer {YOUR_ACCESS_TOKEN}
Prüfen Sie die Ablaufzeit des Tokens und generieren Sie bei Bedarf ein neues Token.
Bitte senden Sie die Angaben zu „Benutzername" (E-Mail-Adresse des OAuth-Kontos) und „Identifikation" per E-Mail, um die Freischaltung / Verknüpfung zu beantragen.
Fehlende oder ungültige Parameter
400 Bad Request
Problem:
Der Server meldet
400 Bad Request, weil die übergebenen Parameter fehlen oder fehlerhaft sind.
Ursachen:
Pflichtparameter fehlen im API-Request.
Ein falsches Datenformat wurde übergeben (z. B. falsche JSON-Struktur).
Lösung:
Überprüfen Sie den Request-Body oder Query-String auf Vollständigkeit. Beispiel für einen korrekten Request:
{
"address": {
"street": "Musterstrasse",
"houseNumber": "10",
"zip": "8001",
"city": "Zürich"
}
}
Prüfen Sie die Pflichtfelder und das Format in der Swagger-Dokumentation.
Zu viele Anfrage
429 Too Many Requests
Problem:
Die API lehnt Anfragen mit
429 Too Many Requestsab.
Ursachen:
Das Rate-Limit wurde überschritten (z. B. zu viele Abfragen pro Minute).
Lösung:
Reduzieren Sie die Abfragerate oder implementieren Sie eine Retry-Logik mit Wartezeiten.
Prüfen Sie das aktuelle Limit in der technischen Doku oder fragen Sie höhere Limits bei unserem Support-Team an.
Interner Serverfehler
500 Internal Server Error
Problem:
Die API meldet einen unbekannten Fehler auf der Serverseite
500 Internal Server Error.
Ursachen:
Temporäres Problem auf der Serverseite.
Lösung:
Warten Sie kurz und wiederholen Sie die Anfrage.
Falls das Problem bestehen bleibt, wenden Sie sich an den Support.
Datenquelle nicht verfügbar
404 Not Found
Problem:
Die angegebene Datenquelle oder der API-Endpunkt wird nicht gefunden.
Ursachen:
Eine falsche oder nicht verfügbare Quelle wurde im Request definiert.
Lösung:
Überprüfen Sie die angegebenen Parameter, insbesondere den source-Wert:
GET /api/Search/Autocomplete?source=Directories&value=Musterstrasse
Last updated