HTTP-Statuscodes
Dieses Dokument definiert die HTTP-Statuscode-Spezifikation der MTPush REST API.
Die neue Version der MTPush Push API v4 entspricht dieser Spezifikation.
HTTP-Statuscode-Definition
| Code | Beschreibung | Erläuterung |
|---|---|---|
| 200 | OK | Erfolg! |
| 400 | Ungültige Anfrage | Die Anfrage ist ungültig. Die entsprechende Beschreibung erläutert den Grund. |
| 401 | Nicht verifiziert | Keine Verifizierungsinformationen oder Verifizierung fehlgeschlagen. |
| 403 | Abgelehnt | Die Anfrage wurde verstanden, aber nicht akzeptiert. Die entsprechende Beschreibung erläutert den Grund. |
| 404 | Nicht gefunden | Die Ressource existiert nicht, der angeforderte Benutzer existiert nicht oder das angeforderte Format wird nicht unterstützt. |
| 405 | Unzulässige Anfragemethode | Die Schnittstelle unterstützt diese Anfragemethode nicht. |
| 410 | Offline | Die angeforderte Ressource ist offline. Bitte beachten Sie die entsprechende Ankündigung. |
| 429 | Zu viele Anfragen | Die Anfrage überschreitet das Frequenzlimit. Die entsprechende Beschreibung erläutert den konkreten Grund. |
| 500 | Interner Serverfehler | Ein interner Fehler ist auf dem Server aufgetreten. Bitte kontaktieren Sie uns, um das Problem schnellstmöglich zu lösen. |
| 502 | Ungültiger Proxy | Der Dienstserver ist offline oder wird gerade aktualisiert. Bitte versuchen Sie es später erneut. |
| 503 | Temporärer Dienstausfall | Der Server konnte auf die Anfrage nicht reagieren. Bitte versuchen Sie es später erneut. |
| 504 | Proxy-Timeout | Der Server läuft, kann aber auf die Anfrage nicht reagieren. Bitte versuchen Sie es später erneut. |
Zu beachtende Spezifikationen für HTTP-Statuscodes
- 200 darf nur für erfolgreiche Anfragen verwendet werden. Verwenden Sie den Rückgabecode 200 nicht für Ausnahmen.
- Bei Geschäftslogikfehlern sollten möglichst spezifische 4xx-Fehlercodes verwendet werden, andernfalls 400.
- Bei internen Serverfehlern ohne spezifischen Fehlercode verwenden Sie 500.
- Bei Geschäftsausnahmen wird der Rückgabeinhalt im JSON-Format zur Definition von Fehlerinformationen bereitgestellt.

