Fehler & Antworten

Integrationsleitfaden für mobile App

HTTP-Statuscodes

200	OK - Anfrage erfolgreich.
204	No Content - returned for `OPTIONS` preflight requests (CORS).
400	Bad Request - fehlender oder ungültiger Parameter.
401	Unauthorized - Token fehlt oder ist ungültig.
404	Not Found - Endpoint oder Ressource existiert nicht.
405	Method Not Allowed - falsche HTTP-Methode für diesen Endpoint.

Erfolgsantwort-Schema

JSON

{
  "success": true,
  "...": "endpoint-specific fields"
}

Fehlerantwort-Schema

JSON

{
  "success": false,
  "message": "Human-readable error description"
}

CORS

All API responses include the following headers, so the API can be called from web clients:

HTTP

Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, OPTIONS
Access-Control-Allow-Headers: Authorization, Content-Type, X-API-Token

Browsers send a preflight OPTIONS request before a cross-origin POST. The API responds with 204 No Content and the CORS headers above - no body required.