Richiesta Massiva

/entities

La richiesta massiva, consente di ottenere in forma aggregata tutti i metadata aggiornati rilasciati da AgiD sul Registry oppure l’insieme di metadata richiesto. Tale modalità può essere utilizzata dagli IdP per aggiornare il registro locale attraverso procedure schedulate in esecuzione automatica. La chiamata all'endpoint produce tutti i metadata sotto forma di XML aggregato

get/entities

Request

Base URL: https://registry.spid.gov.it
URL: https://registry.spid.gov.it/entities
Auth: none declared

Query parameters

codestring

Specifica il Codice (IPA o PIVA) o la lista dei Codici, separati da virgola (o da virgola e spazi)

Example:code1,code2

code_cistring

Specifica il Codice (IPA o PIVA) case insensitive o la lista dei Codici case insensitive, separati da virgola (o da virgola e spazi)

Example:cOdE1,CoDe2

entity_type'sp' | 'idp' | 'aa'

Filtro per tipologia di ente (IDP, SP, AA).

Example:idp

updated_fromstring

Recupera i metadata aggiornati da una specifica data (YYYY-MM-DD o YYYY-MM-DD HH:mm:ss).

Example:2019-05-17 00:00:00

deleted_fromstring

Recupera i metadata non più presenti o cancellati da una specifica data (YYYY-MM-DD).

Example:2019-05-17

created_beforestring

Recupera i metadata esistenti ad una specifica data (YYYY-MM-DD).

Example:20190517

created_afterstring

Recupera i metadata esistenti ad una specifica data (YYYY-MM-DD).

Example:20190517

valid_atstring

Recupera i metadata esistenti ad una specifica data (YYYY-MM-DD).

Example:20190517

organization_type'pa' | 'pr'

Filtro per tipologia di ente (se PA o Privato).

Example:pr

federation_type'sp' | 'ag'

Filtro per tipologia di federazione (SP o Aggregatore).

Example:sp

aggregator_codestring

Filtro per codice dell’ente aggregatore ovvero IPA o PIVA.

Example:UICCIAA

eidas_ready'Y' | 'N'

Filtro su attributi eIDAS.

Example:Y

only_entity_id'Y' | 'N'

Restituisce solo gli entity_id.

Example:Y

file_namestring

Restituisce il metadata identificato dal nome file.

Example:agid.xml

output'json' | 'jwt'

Formato del risultato della ricerca.

Example:json

custom'PAD2026' | 'info_display_base'

applica il filtro custom specificato

Example:PAD2026

pageinteger

Numero di pagina da restituire, a partire dal valore 1.

numMetadatainteger

Numero di metadata per ogni pagina.

orderby'entity_id' | 'code' | 'code_ci' | 'organization_name' | 'lastupdate_date'

applica l'ordinamento in funzione del parametro indicato

Example:lastupdate_date

order'asc' | 'desc'

applica l'ordinamento crescente (asc) o decrescente (desc)

Example:desc

Response

Risposta contenente il set di metadata risultante dalla query. Nel caso in cui sia specificato il parametro only_entity_id=Y, la Response conterrà esclusivamente i riferimenti ai metadata. **NOTA Gli eventuali parametri utilizzati sono restituiti nella Response come attributi nell’Header

Example response

{
  "Entita": [
    {
      "entity_id": "https://entityID.unico/dell/SP",
      "file_name": "isssss.xml",
      "file_hash": "06bdad0dd2812c5b37857b96e5ecc977367fd0a8c2129a0c275c8dc8f48",
      "code": "xyz",
      "signing_certificate_x509": [
        "MIIGujCCBKKgAwI...cY0LXQ=="
      ],
      "organization_name": "Nome organizzazione",
      "organization_display_name": "Display name",
      "organization_type": "PA",
      "federation_type": "SP",
      "single_logout_service": [
        {
          "Binding": "urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect",
          "Location": "https://authconc01.xyz.it/auth/realms/xyz-concorsi/broker/spidid/endpoint"
        }
      ],
      "assertion_consumer_service": [
        {
          "Binding": "urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect",
          "Location": "https://authconc01.xyz.it/auth/realms/xyz-concorsi/broker/spidid/endpoint"
        }
      ],
      "attribute_consuming_service": [
        {
          "ServiceName": "Servizi xyz",
          "ServiceDescription": "Questo servizio fornisce..."
        }
      ],
      "eidas_ready": "N",
      "create_date": "2021-12-20 12:51:12",
      "lastupdate_date": "2021-12-20 12:51:12",
      "_deleted": "N",
      "_disabled": "N",
      "registry_link": "https://registry.spid.gov.it/entities/http%3A%2F%2Fwww.xyz.it"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.