1.Registrati & Accedi
- Crea un account sviluppatore Shell o accedi.
- Vai su "Le mie app", fai clic su "Aggiungi app" e assegna un nome al tuo progetto.
- Seleziona le API che desideri testare
2.Ottieni le tue credenziali
- Vai su "Le mie app" nel tuo profilo, clicca su "Visualizza app" e copia la tua chiave API e il tuo segreto.
- Utilizza il tuo strumento di test delle API preferito (ad es. Postman, Insomnia, curl).
3. Prova le API di base
- API di localizzazione (Punti di ricarica pubblici per veicoli elettrici, Siti di mobilità B2B) sono disponibili immediatamente.
- Operazioni che possono essere testate senza un account Shell:
| Scenario | Descrizione |
|---|---|
| Autenticazione | Verifica chiave API/segreto con una semplice richiesta per confermare l’accesso. |
| Recupero delle località | Utilizzare l’impaginazione per ottenere la prima o una pagina specifica delle località EV. |
| Filtraggio e ricerca | Filtrare per paese/operatore o recuperare i dati in base all’ID della località (includere sia i casi positivi che quelli negativi). |
4. Richiedi accesso avanzato
Per API come Gestione delle carte di mobilità, SmartPay, oppure Transazioni recenti della Mobility Card il nostro team di assistenza API dovrà creare e personalizzare un account cliente Mobility nel nostro sistema di gestione della flotta.
L’accesso completo richiede un rapporto cliente verificato.
Per richiedere l’accesso, crea un account e apri un ticket di assistenza
5.Passaggio all’ambiente di produzione
- Dopo aver firmato l’addendum, riceverai le credenziali per l’ambiente di produzione.
- Iscriviti alle notifiche per ricevere aggiornamenti e avvisi di manutenzione
Gestione degli errori
Le API Shell restituiscono codici di stato HTTP standard e codici di errore personalizzati per maggiore chiarezza.
Per esempi dettagliati e best practice, visita Gestione degli errori e best practice.
