Skip to main content

Are there any breaking changes in the new endpoints besides authentication?

Feature Old New Impact
Authentication Mechanism Basic Authentication (username & password in headers) OAuth 2.0 (token-based authentication) Existing integrations must be updated to handle token generation and renewal.
Mandatory Request ID Optional or not required RequestId is mandatory in every request All client applications must generate and include a unique Request ID per call.
HTTP Status Code Compliance Custom or inconsistent status codes Standard HTTP status codes (e.g., 200, 400, 401, 500) Error handling logic in client apps may need to be revised.
Uniform Request/Response Structure Varying formats across endpoints Standardized JSON structure for all read/write APIs Parsing logic and data models in client systems may need to be updated.
Enhanced Error Payload Minimal or generic error messages Detailed error structure with codes, messages, and hints Clients should update error-handling routines to leverage new fields.
Endpoint URLs and Parameters Legacy endpoint paths and parameter names Updated endpoint paths and parameter naming conventions All endpoint URLs and request payloads must be reviewed and updated.

About us

The Shell Developer Portal supports partners in onboarding to Shell APIs and turning ideas into production-ready solutions.

 

Shell logo

Contact

Login to your account

Ask AI Assistant about Shell APIs and API Products