> ## 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.

# Référence de l’API

> Authentifiez-vous, résolvez les entités, interrogez les données, effectuez des analyses et découvrez les métadonnées via l’API REST de Credit Benchmark.

Les API Credit Benchmark offrent un accès programmatique à la résolution d’entités, aux données brutes au niveau des entités, aux analyses calculées et aux métadonnées en vue de leur intégration dans les workflows de gestion des risques et les pipelines de reporting. Toutes les routes sont relatives à `https://gateway.creditbenchmark.com`.

<Tip title="Démarrage rapide">
  Authentifiez-vous auprès de `POST /api/security/token`. Si vous disposez déjà de `CB_ID` , ignorez la résolution d’entités et passez directement aux `POST /analytics/v2/data/getdata` ou aux points d’extrémité d’analyse sous `/analytics/v2/data/`.
</Tip>

## Fonctionnement

<Steps>
  <Step title="Obtenir un jeton">
    Appelez `POST /api/security/token` avec votre `Username` et `Password`. Réutilisez le jeton d’authentification « bearer » renvoyé jusqu’à son expiration.
  </Step>

  <Step title="Résolvez les entités (si nécessaire)">
    Si vos données sources utilisent des noms d’entreprises plutôt que des identifiants CB, effectuez une requête `POST /matching/text/match_external` pour les résoudre. Conservez les identifiants mis en correspondance comme `CB_ID` valeurs pour les appels d’analyse.
  </Step>

  <Step title="Vérifiez les champs disponibles">
    Appelez `GET /analytics/v2/metadata/columns` pour connaître les champs, types de données et droits disponibles avant de créer vos requêtes.
  </Step>

  <Step title="Interroger les analyses">
    Commencez par `POST /analytics/v2/data/getdata` pour obtenir des résultats au niveau des lignes. Utilisez les points de terminaison d’analyse spécifiques pour les tendances, les ventilations, les changements de notation et les distributions.
  </Step>

  <Step title="Découvrez les métadonnées">
    Utilisez les chemins de métadonnées sous `/analytics/v2/metadata/` pour connaître les colonnes, les échelles de notation, les schémas sectoriels et géographiques, ainsi que les dates d’entrée en vigueur disponibles.
  </Step>
</Steps>