Tabella dei contenuti
🔢 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
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’:
1### REQUEST
2curl --location --request POST 'https://api.io.pagopa.it/api/v1/messages/AAAAAA00A00A000A' \
3--header 'Ocp-Apim-Subscription-Key: __YOUR_API_KEY__' \
4--header 'Content-Type: application/json' \
5--data-raw '{
6"content": {
7"subject": "My first IO app message with min 10 character",
8"markdown": "This is my first message to the IO app. Use body markdown format with min 80 character"
9}
10}'
111### RESPONSE
2{
3 "id": "01EM6X4JB9VSZTQ8H16KMQFCEJ"
4}
5
Hai bisogno di aiuto?
Scrivi un’email in cui descrivi il tuo problema o dubbio all’indirizzo onboarding@io.italia.it
Dicci cosa ne pensi
Per segnalare problemi o dare feedback, lascia un commento nello spazio Github dell'app IO