Welcome to the Shell Developer Portal, we support developers, product managers, startups and enterprises create amazing digital experiences. This getting started guide is here to help you better onboard to Shell APIs, how to register an account, how to authenticate and how to get live. We are constantly updating our APIs, services and onboarding processes, check here and our release notes page for updates.
Create a Shell Developer Account by clicking here. Creating an account will allow you to see all of the APIs that are available to be used by Partners, as some of these will not be available until login. You can then go through the APIs you might be interested in on the APIs page. You can then use the Swagger UI to test some requests and responses to see if the API can meet your specific needs.
Some APIs are restricted access wise, if you find that there are APIs you cannot access with your credentials or you are having issues please login and raise a support case or contact email@example.com. The API customer support team will be able to help you with any issues you are facing and aim to resolve them in 24-48 hours.
Shell APIs use API keys to authenticate requests. You will be able to view and manage your API keys in your My Apps dashboard where you will see all of your existing projects and associated credentials. API keys are the gateway into accessing Shell APIs for your business, they will have significant authority please ensure that you keep them as secure as possible, they should not be shared publicly. All calls should be made over HTTPS. Calls made over HTTP will fail, requests without authentication will also fail. There are two ways to authenticate to Shell APIs, Basic Auth and OAuth2.
Once you are ready to move your project from test through to Production environment, you will need to ensure that you have fully tested the APIs and they meet your projects needs. Pricing and contracts (if not already existing) will need to be agreed and signed, firstname.lastname@example.org can share further details on this process.
Timings There are a lot of questions about how fast we can get live. The short answer is this depends on a few factors, existing or new partner, type of integration & experience of the engineering team working on the project. Some projects take a matter of days to get to production others can be a lot longer. Each integration is unique although the APIs are standardized. Our Station Locator API might be simple to integrate with where as some of our Digital Payments offering slightly more complex as there are more API calls and tests that need to be completed. Plus with the commercialization of some APIs ensuring we get the right agreement for you is critical and this can take time.
Once you are ready to move your project from test through to Production environment, you will need to ensure that you have fully tested the APIs and they meet your projects needs. Pricing and contracts (if not already existing) will need to be agreed and signed.