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

Upload service logo by service ID

PUThttps://api.io.pagopa.it/api/v1/manage/services/{serviceId}/logo

Authorization

ManageSubscriptionKey

Path parameters

serviceId*string

ID of the service

Body

application/json

Updated service payload

logo*string (byte)

Response

204400401403404429500

Service logo updated successfully

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://api.io.pagopa.it/api/v1/manage/services/{serviceId}/logo', {
    method: 'PUT',
    headers: {
      "Ocp-Apim-Subscription-Key": "ManageSubscriptionKey <apiKey>",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "logo": "text"
    }),
});
const data = await response.json();

Response

400500

{
  "type": "https://example.com/problem/constraint-violation",
  "title": "text",
  "status": 200,
  "detail": "There was an error processing the request",
  "instance": "https://example.com"
}

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