LogoLogo
v4.0
v4.0
  • 🏠Guida tecnica
  • 🕗Changelog
  • 🔢Setup iniziale
    • Adesione tramite l'Area Riservata
    • Iscrizione al Developer Portal
  • Funzionalità
    • 📦Pubblicare un servizio
      • Creare un servizio
      • Provare un servizio in test
      • Revisione del servizio
      • Visibilità del servizio
      • Importare servizi nell'Area Riservata
      • Dati obbligatori
        • Attributi
        • Service Metadata
      • Informazioni sensibili
      • Stato del servizio
      • Chiave manage
    • ✉️Inviare un messaggio
      • Messaggi di test
      • 📎Aggiungere allegati (Premium)
        • Specifiche degli endpoint di recupero degli allegati
  • 📐API
    • 📐OpenAPI
    • API Servizi
      • Manage Service: Get
      • Manage Service: Get keys
      • Manage Service: Get User Services
      • Manage Service: Create
      • Manage Service: Delete
      • Manage Service: Update
      • Manage Service: Request Review
      • Manage Service: Release
      • Manage Service: Get Released
      • Manage Service: Unpublish
      • Manage Service: Regenerate api key
      • Manage Service: Upload service logo
      • Upload organization logo
    • API Messaggi
      • Get a User Profile using POST
      • Submit a Message passing the user fiscal_code in the request body
      • Get Message
      • Get Subscriptions Feed
      • ⚠️Get a User Profile
      • ⚠️Submit a Message passing the user fiscal_code as path parameter
    • Errori comuni
    • Specifiche API
  • 🔑Abilitazioni
    • Test con Codici Fiscali reali
    • Test invio avvisi pagoPA
    • Invio messaggi massivo
    • Subscription feed
    • Gestione dei servizi
    • Funzionalità Premium
  • Risorse Utili
    • ❓Supporto agli Enti
    • 📘Glossario
Powered by GitBook
On this page
  • service_name
  • organization_name
  • organization_fiscal_code
  • department_name
  • authorized_cidrs
  • max_allowed_payment_amount
  • version
  • require_secure_channels
  • service_id
  • id
  • authorized_recipients
  • primary_key
  • secondary_key
  1. Funzionalità
  2. Pubblicare un servizio
  3. Dati obbligatori

Attributi

service_name

Descrizione

Nome del servizio visualizzato in app

Tipo

Stringa

Obbligatorio

Sì

"Carta d'Identità Elettronica"

"TARI"

organization_name

Descrizione

Nome dell'ente che eroga il servizio

Tipo

Stringa

Obbligatorio

Sì

“Comune di Milano”

organization_fiscal_code

Descrizione

Codice Fiscale dell’ente che eroga il servizio

Tipo

Stringa

Obbligatorio

Sì

“00907501001”

department_name

Descrizione

Nome del dipartimento dell’ente che eroga il servizio

Tipo

Stringa

Obbligatorio

Sì

“Anagrafe”

authorized_cidrs

Di default non sono applicate restrizioni. È obbligatorio inserire le restrizioni IP prima del passaggio in produzione.

Descrizione

Lista IP/subnet autorizzate per richiamare il servizio

Tipo

Lista di stringhe

Obbligatorio

Sì

1.2.3.4/32;2.3.4.5/32

max_allowed_payment_amount

Descrizione

Importo massimo autorizzato nei messaggi che contengono un avviso di pagamento pagoPA. L’importo è inteso in centesimi di euro, cioè come parte intera più due cifre decimali. Per esempio, per impostare una soglia di pagamento di 1500,00 € bisogna inserire il valore 150000

Tipo

Intero

Obbligatorio

Sì, se il servizio prevede l’invio di avvisi di pagamento pagoPA

1000000

version

Questo campo è automaticamente gestito dall’infrastruttura di IO ed è considerato in sola lettura.

Descrizione

Numero di versione del servizio

Tipo

No

Obbligatorio

Intero

1

require_secure_channels

Descrizione

Flag che permette di anonimizzare le notifiche inviate agli utenti (push e email). Il valore predefinito è false

Se true, il contenuto è generico: "Hai un nuovo messaggio"

Se true, non viene inviata alcuna email, a prescindere dalle preferenze dell'utente.

Tipo

Booleano

Obbligatorio

No

false

service_id

Questa proprietà non è modificabile ed è considerata in sola lettura.

Descrizione

Identificativo del servizio. È il riferimento da usare come parametro nel path della richiesta per invocare i servizi come Update Service e Upload Service Logo

Tipo

Stringa

“01EXPKTF05Z2AWEN0PN99QZE79”

id

Questa proprietà non è modificabile ed è considerata in sola lettura.

Questa proprietà non va inviata nelle request e sarà aggiornata in automatico ad ogni modifica del servizio.

Descrizione

Identificativo del servizio

Tipo

Stringa

“01EXPKTF05Z2AWEN0PN99QZE79-0000000000000001”

authorized_recipients

Alla creazione di un servizio, è possibile inviare messaggi soltanto al cittadino di test con Codice Fiscale AAAAAA00A00A000A. Questa restrizione non si applica agli utenti abilitati all’invio a qualsiasi Codice Fiscale.

Descrizione

Lista dei Codici Fiscali a cui il servizio può inviare messaggi

Tipo

Lista di stringhe

Obbligatorio

No

“AAAAAA00A00A000A”

primary_key

Descrizione

Chiave primaria del servizio da inviare nell’header Ocp-Apim-Subscription-Key. Chiave primaria e secondaria sono equivalenti e vengono duplicate per cambiarle senza interrompere il servizio

Tipo

stringa

Obbligatorio

n.a.

”__YOUR_API_KEY__”

secondary_key

Descrizione

Chiave secondaria del servizio da inviare in alternativa alla chiave primaria nell’header Ocp-Apim-Subscription-Key. Chiave primaria e secondaria sono equivalenti e vengono duplicate per cambiarle senza interrompere il servizio

Tipo

stringa

Obbligatorio

n.a.

__YOUR_API_KEY__”

PreviousDati obbligatoriNextService Metadata

Last updated 1 year ago

Notifica Push

Email

📦
🔔
✉️