Attributi

service_name

Definizione

Descrizione	Nome del servizio visualizzato in app
Tipo	Stringa
Obbligatorio	Sì

Esempio

"Carta d'Identità Elettronica"

"TARI"

organization_name

Definizione

Descrizione	Nome dell'ente che eroga il servizio
Tipo	Stringa
Obbligatorio	Sì

Esempio

“Comune di Milano”

organization_fiscal_code

Definizione

Descrizione	Codice Fiscale dell’ente che eroga il servizio
Tipo	Stringa
Obbligatorio	Sì

Esempio

“00907501001”

department_name

Definizione

Descrizione	Nome del dipartimento dell’ente che eroga il servizio
Tipo	Stringa
Obbligatorio	Sì

Esempio

“Anagrafe”

authorized_cidrs

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

Definizione

Descrizione	Lista IP/subnet autorizzate per richiamare il servizio
Tipo	Lista di stringhe
Obbligatorio	Sì

Esempio

1.2.3.4/32;2.3.4.5/32

is_visible

In fase di test, è importante impostare il valore infalse.

Definizione

Descrizione	Flag che modifica la visibilità del servizio in app
Tipo	Booleano
Obbligatorio	Sì

Esempio

false

max_allowed_payment_amount

Definizione

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

Esempio

1000000

version

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

Definizione

Descrizione	Numero di versione del servizio
Tipo	No
Obbligatorio	Intero

Esempio

1

require_secure_channels

Definizione

Descrizione	Flag che permette di anonimizzare le notifiche inviate agli utenti (push e email). Il valore predefinito è false 🔔 Notifica Push Se true, il contenuto è generico: "Hai un nuovo messaggio" ✉️ Email Se true, non viene inviata alcuna email, a prescindere dalle preferenze dell'utente.
Tipo	Booleano
Obbligatorio	No

Esempio

false

service_id

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

Definizione

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

Esempio

“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.

Definizione

Descrizione	Identificativo versionato del servizio: è la composizione di "service_id"+"version" con zero fill
Tipo	Stringa

Esempio

“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.

Definizione

Descrizione	Lista dei Codici Fiscali a cui il servizio può inviare messaggi
Tipo	Lista di stringhe
Obbligatorio	No

Esempio

“AAAAAA00A00A000A”

primary_key

Definizione

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.

Esempio

”__YOUR_API_KEY__”

secondary_key

Definizione

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.

Esempio

__YOUR_API_KEY__”