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
Non hai ancora completato lâonboarding e hai bisogno di aiuto?
Scrivi unâemail in cui descrivi il tuo problema o dubbio allâindirizzo areariservata@assistenza.pagopa.it.
Dicci cosa ne pensi
Per segnalare problemi o dare feedback, lascia un commento nello spazio Github dell'app IO