| Ancienne | Impact | ||
|---|---|---|---|
| Authentication Mechanism | Basic Authentication (username & password in headers) | OAuth 2.0 (authentification par jeton) | Les intégrations existantes doivent être mises à jour pour gérer la génération et le renouvellement des jetons. | Identification obligatoire de la demande | Optionnelle ou non requise | RequestId est obligatoire dans chaque demande |
Toutes les applications clientes doivent générer et inclure une ID de demande unique par appel. | Conformité des codes d'état HTTP | Codes d'état personnalisés ou incohérents | Codes d'état HTTP standard (par ex, 200, 400, 401, 500) | La logique de traitement des erreurs dans les applications clientes peut devoir être révisée. |
| Structure uniforme des demandes/réponses | Formats variables entre les points d'extrémité | Structure JSON normalisée pour toutes les API en lecture/écriture | La logique d'analyse et les modèles de données dans les systèmes clients peuvent nécessiter une mise à jour. | Enrichissement des messages d'erreur | Messages d'erreur minimaux ou génériques | Structure d'erreur détaillée avec codes, messages et conseils | Les clients doivent mettre à jour les routines de traitement des erreurs afin d'exploiter les nouveaux champs. |
| URL et paramètres d'extrémité | Chemins d'extrémité et noms de paramètres légaux | Chemins d'extrémité et conventions de dénomination des paramètres mis à jour | Toutes les URL d'extrémité et les charges utiles des requêtes doivent être révisées et mises à jour. |
Outre l'authentification, les nouveaux points d'accès comportent-ils des changements radicaux ?
A propos de nous
Le portail des développeurs Shell aide les partenaires à se familiariser avec les API Shell et à transformer leurs idées en solutions prêtes à être mises en production.
Contact
Connectez-vous à votre compte
Êtes-vous un employé de Shell ?
Authentifier