> ## Documentation Index
> Fetch the complete documentation index at: https://docs.creditbenchmark.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Riferimento API

> Effettuare l’autenticazione, risolvere le entità, interrogare i dati, eseguire analisi e individuare i metadati tramite l’API REST di Credit Benchmark.

Le API di Credit Benchmark forniscono accesso programmatico alla risoluzione delle entità, ai dati grezzi a livello di entità, alle analisi calcolate e ai metadati per l’integrazione nei flussi di lavoro relativi al rischio e nelle pipeline di reporting. Tutti i percorsi sono relativi a `https://gateway.creditbenchmark.com`.

<Tip title="Guida rapida">
  Effettuare l’autenticazione tramite `POST /api/security/token`. Se si dispone già di `CB_ID` , salti la risoluzione delle entità e passi direttamente a `POST /analytics/v2/data/getdata` o ai percorsi di analisi riportati di seguito. `/analytics/v2/data/`.
</Tip>

## Come funziona

<Steps>
  <Step title="Ottenere un token">
    Chiamare `POST /api/security/token` con il Suo `Username` e `Password`. Riutilizzare il token bearer restituito fino alla sua scadenza.
  </Step>

  <Step title="Risolvere le entità (se necessario)">
    Se i dati di origine utilizzano nomi di società anziché identificatori CB, esegua la chiamata `POST /matching/text/match_external` per risolverli. Conservi gli identificatori corrispondenti come `CB_ID` valori per le chiamate di analisi.
  </Step>

  <Step title="Verifica i campi disponibili">
    Eseguire la chiamata `GET /analytics/v2/metadata/columns` per verificare quali campi, tipi di dati e autorizzazioni sono disponibili prima di creare le richieste.
  </Step>

  <Step title="Interrogazione delle analisi">
    Inizi con `POST /analytics/v2/data/getdata` per ottenere risultati a livello di riga. Utilizzi gli endpoint di analisi specifici per tendenze, ripartizioni, variazioni di rating e distribuzioni.
  </Step>

  <Step title="Esplora i metadati">
    Utilizzi i percorsi dei metadati disponibili in `/analytics/v2/metadata/` per le colonne disponibili, le scale di valutazione, gli schemi settoriali e geografici e le date di entrata in vigore.
  </Step>
</Steps>