Skip to main content
Les API Credit Benchmark fournissent 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.
Enregistrez une fois auprès de nous une paire de clés ES256, puis signez une assertion client et échangez-la à l’adresse POST /api/security/token contre un jeton d’accès. Vous découvrez l’accès M2M ? Commencez par Authentification machine à machine. Si vous disposez déjà de CB_ID , ignorez la résolution d’entités et passez directement aux POST /beta/data/getdata ou aux points d’extrémité d’analyse ci-dessous /beta/data/.

​
Fonctionnement

1

Enregistrez une paire de clés

Générez une paire de clés publique/privée ES256 sur la machine qui appellera l’API et envoyez-nous la clé publique. Nous l’enregistrerons et vous enverrons votre OAuthClientId et KID. Il s’agit d’une configuration unique par machine et par environnement. Consultez Configuration de la paire de clés.
2

Obtenir un jeton

Signez une assertion client avec votre clé privée ES256 enregistrée et échangez-la à l’adresse POST /api/security/token contre un jeton « bearer » à durée de vie limitée. Demandez un nouveau jeton lorsqu’il expire. Consultez Demander un jeton d’accès.
3

Résolvez les entités (le cas échéant)

Si vos données sources utilisent des noms d’entreprises plutôt que des identifiants CB, effectuez une requête POST /beta/text/match_external pour les résoudre. Conservez les identifiants mis en correspondance comme CB_ID valeurs pour les appels d’analyse.
4

Vérifiez les champs disponibles

Appelez GET /beta/metadata/columns pour connaître les champs, types de données et droits disponibles avant de créer vos requêtes.
5

Interroger les analyses

Commencez par POST /beta/data/getdata pour obtenir un résultat 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.
6

Découvrez les métadonnées

Utilisez les chemins de métadonnées sous /beta/metadata/ pour connaître les colonnes disponibles, les échelles de notation, les schémas sectoriels et géographiques, ainsi que les dates d’entrée en vigueur.