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

serviceIdstringRequired

ID of the service

Body

logostringRequired

Responses

204

Service logo updated successfully

400

Invalid payload.

application/json

401

Unauthorized

403

Forbidden

404

Not found

429

Too many requests

500

Internal server error

application/json

put

HTTPcURLJavaScriptPython

PUT /api/v1/manage/services/{serviceId}/logo HTTP/1.1
Host: api.io.pagopa.it
Ocp-Apim-Subscription-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 15

{
  "logo": "text"
}

No content

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