Iniziare con le API
Segui questa guida per configurare il tuo accesso ed effettuare la prima chiamata API.
Prerequisiti
- Un account sviluppatore su questo portale
- Un client HTTP: cURL, Postman o Insomnia
Passo 1 — Creare un account
- Fare clic su Registrati in alto a destra
- Compilare il modulo di registrazione
- Confermare il proprio indirizzo email tramite il link ricevuto
- Attendere l'approvazione dell'account da parte dell'amministratore
Passo 2 — Creare un'applicazione
- Accedere al portale
- Andare su Le mie applicazioni
- Fare clic su Crea un'applicazione
- Inserire il nome e la descrizione
- Selezionare le API a cui si desidera accedere
Passo 3 — Ottenere le credenziali
Una volta creata l'applicazione:
- Copiare l'Application Secret visualizzato e conservarlo in un luogo sicuro. Non sarà più visibile dopo questo passaggio — è possibile generarne uno nuovo se necessario.
Passo 4 — Prima chiamata API
Una volta approvata l'applicazione, è possibile testare una chiamata API:
curl -X GET "https://api.stef.com/v1/transport/orders" \
-H "X-STEF-Client-Id: <YOUR_APPLICATION_SECRET>" \
-H "Content-Type: application/json"