Manage Service: Upload service logo

Descrizione

Questa API permette di caricare il logo di un servizio. È necessario inserire il service_id come path parameter e inserire il logo, in formato base64, nel body del messaggio

Devi usare la nuova chiave manage per la gestione dei servizi.

Per utilizzare questa API è necessario richiedere un'abilitazione specifica.

Upload service logo

put

Upload service logo by service ID

Authorizations

Path parameters

serviceIdanyrequired

ID of the service

Body

logostring · byte · min: 1required

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://api.io.pagopa.it/api/v1/manage/services/{serviceId}/logo' \
  --header 'Ocp-Apim-Subscription-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "logo": "Ynl0ZXM="
  }'

204

400

401

403

404

429

500

204

No body

Service logo updated successfully

Importante

• Le dimensioni del logo dovranno essere necessariamente 300x300 pixel.

• L'immagine deve essere in formato png con sfondo bianco o trasparente.

Eseguendo un caricamento del logo immediatamente dopo la creazione del servizio, è possibile che l’API restituisca un errore 401. Se accade, attendi qualche secondo e carica di nuovo il logo.

Per verificare che il logo del servizio sia caricato correttamente, puoi interrogare la seguente URL:

https://assets.cdn.io.italia.it/logos/services/<SERVICE_ID>.png

dove <SERVICE_ID> è l'id servizio in lowercase.

Esempi

### REQUEST
curl --location --request PUT 'https://api.io.pagopa.it/api/v1/services/manage/SERVICE_ID/logo' \
--header 'Ocp-Apim-Subscription-Key: __YOUR_API_KEY__' \
--header 'Content-Type: application/json' \
--data-raw '{
"logo": "<<Base64ImageString>>"
}'

### RESPONSE
{}

Risorse utili

https://developer.io.italia.it/openapi.html#operation/cmsUpdateServiceLogo