| Merkmal | Alt | Neu | Auswirkungen |
|---|---|---|---|
| Authentifizierungsmechanismus | Basische Authentifizierung (Benutzername & Passwort in Header) | OAuth 2.0 (Token-basierte Authentifizierung) | Bestehende Integrationen müssen aktualisiert werden, um die Generierung und Erneuerung von Token zu ermöglichen. |
| Pflichtige Request-ID | Optional oder nicht erforderlich | RequestId ist in jeder Anfrage obligatorisch |
Alle Client-Anwendungen müssen eine eindeutige Request-ID pro Aufruf generieren und einschließen. |
| HTTP-Statuscode-Konformität | Benutzerdefinierte oder inkonsistente Statuscodes | Standard-HTTP-Statuscodes (z. B., 200, 400, 401, 500) | Die Fehlerbehandlungslogik in Client-Anwendungen muss möglicherweise überarbeitet werden. |
| Einheitliche Request/Response-Struktur | Unterschiedliche Formate an den Endpunkten | Standardisierte JSON-Struktur für alle Lese-/Schreib-APIs | Die Parsing-Logik und Datenmodelle in Client-Systemen müssen möglicherweise aktualisiert werden. |
| Erweiterte Fehlernutzlast | Minimale oder generische Fehlermeldungen | Detaillierte Fehlerstruktur mit Codes, Meldungen und Hinweisen | Kunden sollten ihre Fehlerbehandlungsroutinen aktualisieren, um die neuen Felder zu nutzen. |
| Endpunkt-URLs und -Parameter | Veraltete Endpunktpfade und Parameternamen | Aktualisierte Endpunktpfade und Parameternamenskonventionen | Alle Endpunkt-URLs und Anforderungs-Payloads müssen überprüft und aktualisiert werden. |
Gibt es bei den neuen Endpunkten außer der Authentifizierung noch weitere Änderungen?
Über uns
Das Shell Developer Portal unterstützt Partner bei der Einbindung in die Shell-APIs und dabei, Ideen in produktionsreife Lösungen umzusetzen.
Kontakt
Anmeldung bei Ihrem Konto
Sind Sie ein Mitarbeiter von Shell?
Authentifizieren Sie sich