--- title: "Iniziare" description: "Guida per i clienti esterni per accedere al portale API, creare applicazioni, iscriversi alle API e consumarle." url: "https://api-portal-suitelogi-quaext.stef.com/it/getting-started" image: "https://api-portal-suitelogi-quaext.stef.com/_og/d/c_Ocean.takumi,title_Iniziare,description_~R3VpZGEgcGVyIGkgY2xpZW50aSBlc3Rlcm5pIHBlciBhY2NlZGVyZSBhbCBwb3J0YWxlIEFQSSwgY3JlYXJlIGFwcGxpY2F6aW9uaSwgaXNjcml2ZXJzaSBhbGxlIEFQSSBlIGNvbnN1bWFybGUu,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiM1NTk2ZTYifX19,p_Ii9pdC9nZXR0aW5nLXN0YXJ0ZWQi,s_Ri-UcHoM0bdCkc8K.png" --- **Portale per Sviluppatori** - [API](https://api-portal-suitelogi-quaext.stef.com/it/apis) - [Iniziare](https://api-portal-suitelogi-quaext.stef.com/it/getting-started) - [Guide](https://api-portal-suitelogi-quaext.stef.com/it/guides) - [Supporto](https://api-portal-suitelogi-quaext.stef.com/it/support) [FR](https://api-portal-suitelogi-quaext.stef.com/)|[EN](https://api-portal-suitelogi-quaext.stef.com/en)|[ES](https://api-portal-suitelogi-quaext.stef.com/es)|**[IT](https://api-portal-suitelogi-quaext.stef.com/it)**|[PT](https://api-portal-suitelogi-quaext.stef.com/pt)|[NL](https://api-portal-suitelogi-quaext.stef.com/nl)|[DE](https://api-portal-suitelogi-quaext.stef.com/de) ## 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](#_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](#accesso-ai-portali-api) - Produzione: [https://api-portal-ext.stef.com/](https://api-portal-ext.stef.com/) - Qualifica: [https://api-portal-quaext.stef.com/](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](#_2-creare-unapplicazione) 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. 1. Fai clic sul tuo profilo in alto a destra nel portale 2. Fai clic sul pulsante **Applications** 3. Fai clic sul pulsante **New application** 4. Inserisci il nome e la descrizione della tua applicazione 5. Per condividere questa applicazione con il tuo team, seleziona **This is a team owned application** e scegli il team desiderato 6. Fai clic sul pulsante **Create application** 7. Prendi nota della credential generata durante la creazione Questa credential viene mostrata solo al momento della creazione della tua applicazione e non sarà più visibile in seguito. Conservala con cura. ## [3\. Iscriversi a un'API](#_3-iscriversi-a-unapi) 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: 1. Apri il dettaglio di un'API 2. Fai clic su **Use this API** in alto a destra 3. 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](#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](#_4-consumare-unapi) 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](https://api-suitelogi-ext.stef.com) - Qualifica: [https://api-suitelogi-quaext.stef.com](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](#esempio-di-invocazione) ```bash curl -X GET "https://api.stef.com/v1/transport/orders" \ -H "X-STEF-Client-Id: " \ -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!**. ## [Prossimi passi](#prossimi-passi) ## Catalogo API [Vedi le API →](https://api-portal-suitelogi-quaext.stef.com/it/apis) ## Guide tecniche [Vedi le guide →](https://api-portal-suitelogi-quaext.stef.com/it/guides) ## Istanze APIM [Vedi le istanze →](https://api-portal-suitelogi-quaext.stef.com/it/getting-started/instances) #### [API](#api) - [Catalogo delle API](https://api-portal-suitelogi-quaext.stef.com/it/apis) - [Guida introduttiva](https://api-portal-suitelogi-quaext.stef.com/it/getting-started) #### [Sviluppatori](#sviluppatori) - [Documentazione](https://api-portal-suitelogi-quaext.stef.com/it/guides) - [Buone pratiche](https://api-portal-suitelogi-quaext.stef.com/it/guides/best-practices) - [Portali](https://api-portal-suitelogi-quaext.stef.com/it/getting-started/instances) #### [Supporto](#supporto) - [Supporto tecnico](https://api-portal-suitelogi-quaext.stef.com/it/support) #### [Lingue](#lingue) - [Français](https://api-portal-suitelogi-quaext.stef.com/) - [English](https://api-portal-suitelogi-quaext.stef.com/en) - [Español](https://api-portal-suitelogi-quaext.stef.com/es) - [Italiano](https://api-portal-suitelogi-quaext.stef.com/it) - [Português](https://api-portal-suitelogi-quaext.stef.com/pt) - [Nederlands](https://api-portal-suitelogi-quaext.stef.com/nl) - [Deutsch](https://api-portal-suitelogi-quaext.stef.com/de) © 2026 STEF — Tutti i diritti riservati [Mentions légales](https://www.stef.com/mentions-legales) · [Politique de confidentialité](https://www.stef.com/politique-confidentialite)