Tabella dei contenuti
Configurazione remota
Questa configurazione è necessaria se hai intenzione di utilizzare una delle seguenti funzionalità:
Per entrambe le funzionalità è infatti necessario **mettere a disposizione un **REST web service conforme alla relativa OpenAPI.
Un web service esposto è caratterizzato da un identificativo di configurazione, cioè un codice alfanumerico univoco, generato da IO, che corrisponderà a un set di endpoint e alle relative API key.
Puoi definire una configurazione, richiamarla successivamente, elencare le configurazioni definite e modificarne una creata in precedenza.
Il servizio esposto deve essere costituito da un numero variabile di endpoint, a seconda di cosa si intenda remotizzare per i propri messaggi e del tipo di accordo che hai sottoscritto con PagoPA:
| Endpoint recupero di: | Dati da tornare a IO | Dettagli |
|---|---|---|
| precondizioni all'apertura | titolo e corpo delle precondizioni | |
| dettagli del messaggio |
| i dettagli del messaggio devono corrispondere i flag di intento dichiarati alla creazione del messaggio |
| byte dell'allegato | byte del singolo allegato (solo enti Premium) |
Una volta pronto, utilizza l'API descritta in CRU Configurazioni remote per registrare presso i sistemi di IO i dati necessari, tra cui:
- la URL di base che servirà a IO per comporre gli indirizzi degli endpoint esposti dalla tua Organizzazione (per maggiori informazioni fai riferimento agli esempi riportati in OpenAPI endpoint di recupero dei contenuti remotizzati)
- l**'API key** che IO userà per autenticarsi presso i tuoi sistemi e il relativo header atteso
- l'eventuale preferenza di default relativa alle precondizioni all'apertura dei messaggi (per maggiori informazioni sulle precondizioni fai riferimento a Inviare un messaggio a contenuto remoto)
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