Fehlerbehandlung

Die flu.lu APIs verwenden standardisierte HTTP-Statuscodes und anwendungsspezifische Fehlermeldungen, um den Erfolg oder das Scheitern einer Anfrage anzuzeigen.

Struktur der anwendungsspezifischen Fehlerantworten

Wenn ein anwendungsspezifischer Fehler auftritt, enthält der Antwortkörper nützliche Details, um das Problem zu verstehen:

{
  "error_code": "codice_univoco",
  "message": "Beschreibende Fehlermeldung"
}

Beispiele für häufige anwendungsspezifische Fehler

Fehlender Parameter

{
  "error_code": "missing_parameter",
  "message": "Der Parameter 'url' ist erforderlich und fehlt in der Anfrage."
}

Ungültiger Shortcode

{
  "error_code": "invalid_shortcode",
  "message": "Der angegebene Shortcode ist ungültig oder existiert nicht."
}

Link bereits vorhanden

{
  "error_code": "link_already_exists",
  "message": "Der Link, den du erstellen wolltest, existiert bereits."
}

Maximale Quote erreicht

{
  "error_code": "quota_reached",
  "message": "Du hast die maximale Anzahl an erlaubten verkürzten Links deines Plans erreicht."
}

Allgemeiner interner Fehler

{
  "error_code": "internal_error",
  "message": "Ein interner Fehler ist aufgetreten, versuche es später erneut oder kontaktiere den Support."
}