> ## Documentation Index
> Fetch the complete documentation index at: https://docs.netzfabrik.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Fehlerbehandlung

> HTTP-Statuscodes der NETZFABRIK API und das Format von Fehler- und Validierungsantworten.

Die API nutzt die üblichen HTTP-Statuscodes. Fehlerantworten sind JSON und folgen dem Schema `Error`, Validierungsfehler dem Schema `ConstraintViolation`.

## Statuscodes

| Status | Bedeutung |
| - | - |
| `200 OK` | Anfrage erfolgreich, Antwort enthält die Ressource oder Liste. |
| `201 Created` | Ressource wurde angelegt. |
| `202 Accepted` | Auftrag angenommen, wird asynchron verarbeitet (zum Beispiel Domain-Bestellungen). |
| `204 No Content` | Erfolgreich, keine Antwortdaten (zum Beispiel nach `DELETE`). |
| `400 Bad Request` | Anfrage fehlerhaft, zum Beispiel ungültiges JSON. |
| `401 Unauthorized` | Kein oder ungültiger Token. |
| `403 Forbidden` | Token gültig, aber keine Berechtigung für diese Ressource. |
| `404 Not Found` | Ressource existiert nicht oder gehört nicht zu deinem Konto. |
| `409 Conflict` | Zustand der Ressource erlaubt die Aktion nicht (zum Beispiel Domain bereits gekündigt). |
| `422 Unprocessable Entity` | Validierungsfehler, siehe unten. |
| `429 Too Many Requests` | Rate-Limit erreicht, später erneut versuchen. |
| `5xx` | Serverfehler, bitte mit `X-Request-Id` an den Support melden. |

## Allgemeiner Fehler

```json theme={null}
{
  "title": "An error occurred",
  "detail": "Not Found",
  "status": 404
}
```

## Validierungsfehler

Bei `422` enthält die Antwort eine Liste aller fehlgeschlagenen Prüfungen. `propertyPath` benennt das betroffene Feld.

```json theme={null}
{
  "title": "An error occurred",
  "detail": "name: Dieser Wert sollte nicht leer sein.",
  "status": 422,
  "violations": [
    {
      "propertyPath": "name",
      "message": "Dieser Wert sollte nicht leer sein.",
      "code": "c1051bb4-d103-4f74-8988-acbcafc7fdc3"
    }
  ]
}
```

## Vorgangs-ID

Jede Antwort trägt den Header `X-Request-Id`. Gib diese ID bei Support-Anfragen an, damit wir den Vorgang bis zum Registrar oder Hypervisor nachverfolgen können.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.