1.Registrácia & Prihlásiť sa
- Vytvorte si vývojársky účet Shell alebo sa prihláste.
- Prejdite do časti Moje aplikácie, kliknite na Pridať aplikáciu a zadajte názov svojho projektu.
- Vyberte rozhrania API, ktoré chcete otestovať
2.Získajte svoje prihlasovacie údaje
- Prejdite do časti Moje aplikácie vo vašom profile, kliknite na Zobraziť aplikáciu a skopírujte si kľúč API a tajný kód.
- Použite svoj obľúbený nástroj na testovanie API (napr. Postman, Insomnia, curl).
3. Testovanie základných API
- API pre polohu (Verejné lokality EV, Lokality B2B Mobility) sú k dispozícii ihneď.
- Operácie, ktoré je možné testovať bez účtu Shell:
| Scenár | Popis |
|---|---|
| Overenie | Otestujte kľúč/tajný kód API pomocou jednoduchého požiadavku na potvrdenie prístupu. |
| Načítanie lokalít | Použite stránkovanie na získanie prvej alebo konkrétnej stránky lokalít EV. |
| Filtrovanie a vyhľadávanie | Filtrovanie podľa krajiny/operátora alebo načítanie údajov podľa ID lokality (vrátane pozitívnych aj negatívnych prípadov). |
4. Žiadosť o rozšírený prístup
Pre rozhrania API ako Správa kariet Mobility Card, SmartPay alebo Nedávne transakcie s kartou Mobility náš tím podpory API musí vytvoriť a prispôsobiť zákaznícky účet Mobility v našom systéme správy vozového parku.
Plný prístup vyžaduje overený vzťah so zákazníkom.
Ak chcete požiadať o prístup, vytvorte si účet a otvorte žiadosť o podporu
5.Prechod do produkčného prostredia
- Po podpísaní dodatku obdržíte prihlasovacie údaje do produkčného prostredia.
- Prihláste sa na odber oznámení o aktualizáciách a upozornení na údržbu
Spracovanie chýb
Rozhrania API služby Shell vracajú štandardné stavové kódy HTTP a vlastné kódy chýb pre väčšiu prehľadnosť.
Podrobné príklady a osvedčené postupy nájdete na stránke Spracovanie chýb a osvedčené postupy.
