HTTP-Statuscode
In diesem Beitrag werden die Spezifikationen der HTTP-Statuscodes für die MTPush REST API definiert. Die neue Version der MTPush Push API (v4) erfüllt diese Spezifikation.
Statuscode-Definition
| Code | Beschreibung | Detaillierte Erklärung |
|---|---|---|
| 200 | OK | Erfolg! |
| 400 | Ungültige Anfrage | Die Anfrage ist ungültig. Die genaue Ursache wird in der jeweiligen Beschreibung erläutert. |
| 401 | Nicht authentifiziert | Es fehlen Authentifizierungsinformationen oder die Authentifizierung ist fehlgeschlagen. |
| 403 | Abgelehnt | Die Anfrage wurde verstanden, aber nicht akzeptiert. Die genaue Ursache wird in der jeweiligen Beschreibung erläutert. |
| 404 | Nicht gefunden (404) | Die Ressource existiert nicht, der angeforderte Benutzer existiert nicht oder das Anfrageformat wird nicht unterstützt. |
| 405 | Methode nicht erlaubt | Diese Operation unterstützt keine Anfragen mit dieser Methode. |
| 410 | Ressource offline | Die angeforderte Ressource ist offline. Bitte beachten Sie die entsprechende Ankündigung. |
| 429 | Zu viele Anfragen | Die Anzahl der Anfragen überschreitet das Limit. Die genaue Ursache wird in der jeweiligen Beschreibung erläutert. |
| 500 | Interner Serverfehler | Es ist ein interner Fehler auf dem Server aufgetreten. Bitte kontaktieren Sie uns, um das Problem schnellstmöglich zu lösen. |
| 502 | Ungültiger Proxy-Server | Der Dienstserver ist offline oder wird gerade aktualisiert. Bitte versuchen Sie es später erneut. |
| 503 | Dienst vorübergehend nicht verfügbar | Der Server kann auf die Anfrage nicht antworten. Bitte versuchen Sie es später erneut. |
| 504 | Proxy-Zeitüberschreitung | Der Server läuft, kann aber auf die Anfrage nicht antworten. Bitte versuchen Sie es später erneut. |
Konformität
- Der richtige Statuscode ist 200.
- Bei Fehlern in der Geschäftslogik wird ein Statuscode aus dem 4xx-Bereich oder 400 verwendet.
- Bei internen Serverfehlern wird ein Statuscode aus dem 5xx-Bereich oder 500 verwendet.
- Bei Abweichungen in der Geschäftslogik wird der Rückgabeinhalt im JSON-Format zur Definition von Fehlerinformationen verwendet.
