Tabella dei contenuti
Cosa sono gli allegati
Gli enti che hanno sottoscritto il programma Premium possono includere allegati nei messaggi che inviano. Questi allegati vengono recuperati dai sistemi dell'ente mittente nel momento in cui vengono aperti dall'utente.
Quando l'utente apre un messaggio vengono recuperati, oltre ai metadati del contenuto del messaggio, anche quelli relativi ai metadati (endpoint 1). Il recupero del file vero e proprio avviene tramite l'endpoint 2, ovvero con una GET all'indirizzo {baseUrl}/{url}.
Come funziona?
Step 0 - Esponi gli endpoint di recupero degli allegati
Per permettere a IO di recuperare il contenuto di un messaggio e dei suoi allegati, **devi mettere a disposizione un **REST web service conforme alla relativa OpenAPI.
Per maggiori informazioni, leggi le Specifiche degli endpoint di recupero degli allegati.
Per includere gli allegati in un messaggio, oltre agli step indicati in .., devi seguire questi step:
Step 1 - Includi il blocco Third_party_data
Includi il blocco Third_party_data, che contiene le informazioni necessarie per mostrare gli allegati.
Step 2 - Specifica il valore TRUE nel campo Has_attachments
Specifica il valore TRUE nel campo Has_attachments presente nella request.
Step 3 - Specifica il valore ADVANCED nel campo Feature_level_type
Specifica il valore ADVANCED nel campo Feature_level_type presente nella request.
Esempi
Esempio di chiamata per l’invio di un messaggio con allegati:
1curl --location --request POST 'https://api.io.pagopa.it/api/v1/messages' \
2--header 'Ocp-Apim-Subscription-Key: <YOUR_API_KEY>' \
3--header 'Content-Type: application/json' \
4--data-raw '{
5 "content": {
6 "subject": "Messaggio con allegati",
7 "markdown": "# Titolo\n\nTesto del messaggio: contiene **allegati**!",
8 "third_party_data": {
9 "id": "1234567890",
10 "has_attachments": true
11 }
12 },
13 "feature_level_type": "ADVANCED",
14 "fiscal_code": "<validFiscalCode>",
15}'
16Esempio di risposta positiva:
1{
2 "id": "01BX9NSMKVXXS5PSP2FATZMYYY"
3}
4
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