Manage Service: Get

Descrizione

Questa API permette di recuperare tutte le informazioni relative a un servizio. Per funzionare correttamente richiede l'inserimento del service_id come path parameter.

Devi usare la nuova chiave manage per la gestione dei servizi

Retrieve service

Retrieve a service by ID

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

Authorization

ManageSubscriptionKey

Path parameters

serviceId*string

ID of the service

Response

200401403404429500

Service fetched successfully

Body

application/json

idstring

statusCmsServiceLifecycleStatus (object)

last_updateTimestamp (string (UTCISODateFromString))

A date-time field in ISO-8601 format and UTC timezone.

Example: "2018-10-13T00:00:00.000Z"

metadataCmsServiceMetadata (all of)

A set of service metadata properties

name*string

description*string

organization*CmsOrganization (object)

require_secure_channelboolean

authorized_recipientsarray of FiscalCode (string (FiscalCode))

authorized_cidrsarray of CIDR (string)

Allowed source IPs or CIDRs for this service. When empty, every IP address it's authorized to call the IO API on behalf of the service.

max_allowed_payment_amountinteger (int32)

Request

JavaScriptCurlPython

const response = await fetch('https://api.io.pagopa.it/api/v1/manage/services/{serviceId}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200500

{
  "id": "text",
  "status": {
    "value": "draft",
    "reason": "text"
  },
  "last_update": "2018-10-13T00:00:00.000Z",
  "metadata": {
    "web_url": "text",
    "app_ios": "text",
    "app_android": "text",
    "tos_url": "text",
    "privacy_url": "text",
    "address": "text",
    "phone": "text",
    "email": "text",
    "pec": "text",
    "cta": "text",
    "token_name": "text",
    "support_url": "text",
    "scope": "LOCAL",
    "topic": {
      "id": 3,
      "name": "Benessere sociale"
    }
  },
  "name": "text",
  "description": "text",
  "organization": {
    "name": "text",
    "fiscal_code": "12345678901",
    "department_name": "text"
  },
  "require_secure_channel": false,
  "authorized_recipients": [
    "SPNDNL80R13C555X"
  ],
  "authorized_cidrs": [
    "text"
  ]
}

Esempi

### REQUEST
curl --location --request GET 'https://api.io.pagopa.it/api/v1/manage/services/SERVICE_ID' \
--header 'Ocp-Apim-Subscription-Key: __YOUR_API_KEY__'

### RESPONSE
{
  "id": "SERVICE_ID",
  "status": {
    "value": "draft",
    "reason": "string"
  },
  "last_update": "2018-10-13T00:00:00.000Z",
  "name": "string",
  "description": "string",
  "organization": {
    "name": "string",
    "fiscal_code": "12345678901",
    "department_name": "string"
  },
  "require_secure_channel": false,
  "authorized_recipients": [
    "SPNDNL80R13C555X"
  ],
  "authorized_cidrs": [
    "253.710.225.667/5"
  ],
  "max_allowed_payment_amount": 0,
  "metadata": {
    "web_url": "string",
    "app_ios": "string",
    "app_android": "string",
    "tos_url": "string",
    "privacy_url": "string",
    "address": "string",
    "phone": "string",
    "email": "string",
    "pec": "string",
    "cta": "string",
    "token_name": "string",
    "support_url": "string",
    "scope": "LOCAL",
    "topic": {
      "id": 3,
      "name": "Benessere sociale"
    }
  }
}

Risorse utili

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