Errors

Errors

Standard Error Envelope

Geblockte oder ungueltige API-Anfragen sollen ueber ein standardisiertes Error Envelope beantwortet werden. Dadurch koennen Partner Konsistenz zwischen Authentifizierung, Profilzustand und spaeteren Vertragsfehlern erwarten.

Aktuell relevante Fehlercodes

• missing_credentials - HTTP 401
• invalid_credentials - HTTP 403
• credentials_not_configured - HTTP 403
• orders_not_enabled - fuer verifizierte, aber nicht produktiv freigegebene Faelle

Envelope Beispiel

{
  "api_version": "v1",
  "service": "foodbestellen-pos",
  "restaurant_code": "qa-pos",
  "success": false,
  "error": {
    "code": "missing_credentials",
    "message": "Credentials are required.",
    "http_status": 401
  },
  "meta": {
    "orders_enabled": false,
    "orders": [],
    "auth_required": true,
    "authenticated": false,
    "method": null
  }
}

HTTP-Verhalten

FoodBestellen vermeidet oeffentliche Tenant-Enthuellung. Deshalb werden Profil- und Credential-Probleme konservativ behandelt und nicht als offener Hinweis auf reale Restaurantkonfigurationen dokumentiert.