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 & Project Duration:
Integrating our API into your system involves several factors that can influence the timeline.
- Contract with Shell: To use Shell B2B Mobility APIs, you need to have a Shell Fuel Card Agreement with Shell. If you're not a Shell Fleet Solutions customer yet, please get in touch with Shell Fleet Solutions in your local market.
- Scope of Integration: APIs like B2B Mobility Card Transaction Data is generally easier and faster to integrate, compared to more advanced functionality like SmartPay or building an end-to-end process, means more design and development work.
- Experience of the engineering team is another crucial factor that can impact the duration. Teams can face challenges when integrating with outdated software and older devices. On the positive side, REST APIs are not a new technology; they have been widely used for many years and are a well-established standard in modern software development.
- The quality of documentation can streamline the API integration process by providing clear and detailed information, practical examples. This reduces the time developers spend on understanding and implementing the API, leading to a faster and more efficient integration. Utilize the provided SDKs and detailed documentation available on this portal to facilitate a smoother integration process.
- Support availability: Our API has been trusted and utilized by customers since 2018 and we have knowledgeable support team that will guide you during the integration, resolve issues.
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.
