🔢Setup iniziale
Iscrizione
Il primo passo per utilizzare le api di IO è l’iscrizione al developer portal.
Per completare l’iscrizione dovrai validare un indirizzo email, un numero di cellulare e inserire i dati anagrafici e di riferimento dell’ente.
Creazione di un servizio
Terminata la registrazione potrai creare il primo servizio (o sottoscrizione):
Nella colonna sinistra, seleziona “Profilo (sottoscrizioni)”
Controlla i campi precompilati e modificali, se necesario
Crea un servizio selezionando il pulsante “Aggiungi sottoscrizione”
Visualizza e salva le chiavi segrete (API key) associate al servizio
Sandbox
Al termine di questi passi preliminari, potrai testare soltanto le seguenti API di IO utilizzando il cittadino di test con codice fiscale AAAAAA00A00A000A
:
Invio di un messaggio
In questa fase preliminare, l'invio dei messaggi si tradurrà nell’invio di un'email all'indirizzo inserito in fase di registrazione al portale.
A questo punto è possibile inviare il primo messaggio al cittadino di test AAAAAA00A00A000A
utilizzando le API di IO.
Di seguito viene riportato un esempio di chiamata all'API tramite il comando curl
, eseguibile da terminale. In alternativa è possibile utilizzare software di gestione API (es. POSTMAN) avendo accortezza di compilare i dati dell’header e del Content-Type, in particolare la proprietà di API KEY identificato da ‘Ocp-Apim-Subscription-Key’
:
Sostituisci il valore __YOUR_API_KEY__
con una delle api-key del servizio generato in precedenza.
Last updated