We support developers, product managers, startups and enterprises in creating amazing digital experiences. This getting started guide is here to help you better onboard to Shell APIs, learn how to register an account, how to authenticate and how to go live.
Create Account
- Create a Shell Developer Account.
- Explore API catalog: Browse API Catalog and find API that fits your needs
- Test with Swagger UI: Use interactive Swagger UI elements to test
Request Access
After Shell Developer Account was created, navigate to My APPs. Location APIs (EV Public Locations or Gas station Locations will be accessible right away.
For APIs like Mobility Card Management, SmartPay, or Mobility Card Recent Transactions our API Support team needs to create and customize Mobility Customer account in our fleet management system.
The API Support team will be able to help you with any issues you are facing and aim to resolve them in 24-48 hours.
Authentication
Shell APIs use API keys to authenticate requests. You will be able to view and manage your API keys in My Apps where you will see all of your existing projects and associated credentials.
Please ensure that you keep you API keys as secure as possible, they should not be shared publicly.
All calls should be made over HTTPS. Calls made over HTTP or requests without proper authentication will fail. There are two ways to authenticate to Shell APIs, Basic Auth and OAuth2. Higher versions will use OAuth2 as a rule.
Going Live
Steps to Move to Production:
- Perform detailed testing : Ensure you have fully tested the APIs and they meet your project's needs.
- Agree on Pricing and Contracts: If not already existing, these need to be agreed upon and signed. For further details, contact api@shell.com.
Timings:
How Fast Can We Go Live?
Factors Influencing Timelines:
- Existing or new partner
- Type of integration
- Experience of the engineering team
Project Duration:
- Some projects take a matter of days to get to production.
- Others can take significantly longer.
Integration Complexity:
- EV Public Locations : Simple to integrate.
- SmartPay: More complex due to additional API calls and test.
Commercialization:
Ensuring the right agreement for you is critical and can take time.
Post Production
Once your project is live in the Production environment, continuous monitoring and maintenance are essential for smooth operation. Regularly check for updates on the Shell Developer Portal.
For any issues or assistance, contact the API Support team. Keep your API keys secure and monitor their usage to prevent unauthorized access. By staying proactive with the latest developments, you can maximize the benefits of Shell APIs and deliver exceptional digital experiences.