1.Регистрирайте се & Вход
- Създайте акаунт за разработчици в Shell или влезте.
- Отидете в „Моите приложения“, кликнете върху „Добави приложение“ и дайте име на проекта си.
- Изберете API-тата, които искате да тествате
2.Получете вашите идентификационни данни
- Отидете в „Моите приложения“ в профила си, кликнете върху „Преглед на приложението“ и копирайте API ключа и тайния си ключ.
- Използвайте предпочитания от вас инструмент за тестване на API (например Postman, Insomnia, curl).
3. Тестване на основни API-та
- API-та за местоположение (Публични места за електромобили, сайтове за B2B мобилност) са достъпни веднага.
- Операции, които могат да бъдат тествани без акаунт в Shell:
| Сценарий | Описание |
|---|---|
| Удостоверяване | Тествайте API ключа/тайната с просто заявка, за да потвърдите достъпа. |
| Извличане на местоположения | Използвайте пагинация, за да получите първата или конкретна страница с местоположения на електромобили. |
| Филтриране и търсене | Филтрирайте по държава/оператор или извлечете данни по ID на местоположение (включете както положителни, така и отрицателни случаи). |
4. Искане на разширен достъп
За API-та като Управление на карти за мобилност, SmartPay, или Последни транзакции с Mobility Card екипът ни за поддръжка на API трябва да създаде и персонализира клиентски акаунт за Mobility в нашата система за управление на автопарка.
Пълният достъп изисква потвърдена връзка с клиента.
За да поискате достъп, създайте акаунт и отправете заявка за поддръжка
5.Преминаване към производствена среда
- След подписване на допълнението ще получите данни за достъп до производствената среда.
- Абонирайте се за известия за актуализации и предупреждения за поддръжка
Обработка на грешки
API-та на Shell връщат стандартни HTTP статусни кодове и персонализирани кодове за грешки за по-голяма яснота.
За подробни примери и най-добри практики посетете Обработка на грешки и най-добри практики.
