Suggerimento di Ottimizzazione: Introduzione di Parametri di Ricerca per getCertifiedAttributes (PDND-Core-v2) #1455
Description
Buongiorno,
Vorrei sottoporre un suggerimento per migliorare l'usabilità dell'endpoint getCertifiedAttributes nell'API PDND-Core-v2.
Endpoint Coinvolto:
https://developer.pagopa.it/pdnd-interoperabilita/api/pdnd-core-v2#/pdnd-interoperabilita/api/operations/getCertifiedAttributes
Attualmente, l'interrogazione di questo endpoint fornisce l'elenco completo di tutti gli attributi certificati gestiti dal proprio Ente. Quando il catalogo cresce, recuperare l'intero set di dati può risultare meno pratico per chi deve solo consultare attributi specifici.
Sarebbe notevolmente più conveniente per gli sviluppatori e per i processi automatici poter restringere i risultati direttamente alla fonte.
Proposta di Filtri
Suggerisco di arricchire la richiesta getCertifiedAttributes con i seguenti parametri di query opzionali, che consentirebbero un'estrazione mirata degli attributi:
code: Permetterebbe di isolare gli attributi certificati ricercando il loro codice esatto.description: Consentirebbe di trovare rapidamente gli attributi basandosi sul testo contenuto nella loro descrizione.name: Utile per individuare gli attributi attraverso il loro nome identificativo.
L'integrazione di questi filtri consentirebbe agli utilizzatori dell'API di lavorare con set di dati più piccoli e pertinenti, accelerando le operazioni di integrazione e riducendo il traffico di dati non necessario.
Contesto Operativo
È importante notare che, in assenza di filtri, l'unico modo per recuperare l'intero set di dati è ricorrere alla paginazione. Attualmente, con circa 24.000 attributi presenti e un limite di paginazione di 50 elementi, è necessario eseguire 480 chiamate distinte (24.000 / 50) per visualizzare l'intero elenco. L'introduzione dei filtri ridurrebbe drasticamente questo carico di lavoro, rendendo l'API molto più efficiente e gestibile.