Iniziare con le API STEF
Segui questa guida per attivare il tuo account, creare la tua applicazione, iscriverti alle API e chiamarle in tutta sicurezza.
1. Accedere al Portale API
Il portale API STEF ti consente di iscriverti alle API STEF tramite applicazioni consumer personali oppure condivise all'interno di un team.
- Per accedere al portale è necessario richiedere la creazione di un account cliente.
- Per farlo, contatta il tuo referente STEF IT affinché si occupi delle procedure necessarie.
- Riceverai un invito che ti consentirà di creare il tuo account e di accedere ai portali STEF di qualifica e produzione.
La password deve essere rinnovata ogni 200 giorni; verrai avvisato di questa necessità di aggiornamento al momento della connessione al portale.
Accesso ai portali API
- Produzione: https://api-portal-ext.stef.com/
- Qualifica: https://api-portal-quaext.stef.com/
Per poter creare un'applicazione consumer condivisa con il tuo team, è necessario richiedere la creazione di un team al tuo referente STEF IT.
2. Creare un'applicazione
Per poter consumare un'API, devi prima disporre di un'applicazione consumer. La sua creazione genera una credential, l'identificativo della tua applicazione durante una chiamata.
- Fai clic sul tuo profilo in alto a destra nel portale
- Fai clic sul pulsante Applications
- Fai clic sul pulsante New application
- Inserisci il nome e la descrizione della tua applicazione
- Per condividere questa applicazione con il tuo team, seleziona This is a team owned application e scegli il team desiderato
- Fai clic sul pulsante Create application
- Prendi nota della credential generata durante la creazione
3. Iscriversi a un'API
Un'applicazione consumer può iscriversi a una o più API in base alle proprie esigenze.
Usa il menu APIs per consultare il catalogo delle API STEF disponibili.
Vai ai prodotti che ti interessano per visualizzare la documentazione tecnica per sviluppatori, che presenta per ogni API:
- Le diverse operazioni supportate
- La definizione degli oggetti di input e output
- Esempi di codice per consumarle
Per iscriverti a un'API:
- Apri il dettaglio di un'API
- Fai clic su Use this API in alto a destra
- Fai clic sul pulsante Register associato all'applicazione che desideri iscrivere
L'iscrizione dovrà poi essere convalidata da STEF; per questo, contatta il tuo referente STEF IT.
Poiché un'applicazione può iscriversi a più API, ripeti la procedura di iscrizione per ciascuna API che desideri utilizzare.
Consultare e gestire le tue iscrizioni
Per consultare le iscrizioni di un'applicazione, fai clic sul tuo profilo in alto a sinistra e poi su Applications, quindi sul nome della tua applicazione. Nella scheda APIs, visualizzata automaticamente, troverai l'elenco delle tue iscrizioni e il relativo stato.
Puoi anche richiedere l'iscrizione ad altre API direttamente da questo menu, facendo clic su + API.
4. Consumare un'API
Tutte le invocazioni delle API STEF passano attraverso la Gateway API STEF per applicare le regole di sicurezza di accesso, garantire la protezione dei servizi backend del sistema informativo STEF e raccogliere statistiche di invocazione.
Le Gateway API sono accessibili tramite i seguenti URL:
- Produzione: https://api-suitelogi-ext.stef.com
- Qualifica: https://api-suitelogi-quaext.stef.com
Per consumare un'API e rispettare le regole di sicurezza di accesso, aggiungi alla richiesta l'header HTTP X-STEF-Client-Id, valorizzato con la credential della tua applicazione consumer.
La documentazione tecnica per sviluppatori propone, per ogni API pubblicata sulla piattaforma, esempi di codice per invocare la Gateway API da diversi linguaggi: Shell, Python, Node.js, JavaScript, Go, Java, C# e Ruby.
Esempio di invocazione
curl -X GET "https://api.stef.com/v1/transport/orders" \
-H "X-STEF-Client-Id: <YOUR_APPLICATION_SECRET>" \
-H "Content-Type: application/json"
Oltre agli esempi di codice, la documentazione tecnica per sviluppatori propone moduli che consentono di invocare le API direttamente dal portale, in modalità interattiva, tramite il pulsante Try it!.