Passer au contenu principal
L’API sépare l’extraction des données brutes, les analyses calculées et la découverte des métadonnées. Choisissez la route dont le format de sortie correspond à vos besoins : lignes d’entités brutes, une courbe de tendance, un histogramme de notation, un tableau sectoriel, une liste des valeurs les plus volatiles ou des métadonnées de référence. Les quatre routes d’analyse calculent des résumés côté serveur à partir de votre scope. Utilisez getdata lorsque vous avez besoin d’une ligne par entité et par date. Utilisez les routes de métadonnées avant de créer une interface utilisateur ou une intégration, en particulier metadata/columns pour connaître les noms de champs, types de données, filtres, facettes et droits disponibles.

Routes de données et d’analyse

RouteDonnées d’entrée requisesQuand l’utiliser
getdatascopeExports, séries chronologiques ou modèles en aval à partir de champs bruts au niveau des entités
aggregatetrendscopeÉvolution de la qualité de crédit du portefeuille
creditbreakdownscope, facet_columnDernier récapitulatif par secteur, pays ou colonne de portefeuille personnalisée
entityratingchangescopeMises à niveau, rétrogradations ou variations de Consensus PD sur une fenêtre rétrospective
ratingdistributionscopeComposition d’un portefeuille par niveau de notation

Routes de métadonnées

ItinéraireDonnées d’entrée requisesQuand l’utiliser
metadata/columnsAucunVérifiez les noms de champs côté requête, les types de données, les filtres de portée, les facettes et les exigences en matière d’autorisations
metadata/rating-scalesAucunChargement des métadonnées CB21, CB7 et à l’échelle du client pour les étiquettes, l’ordre et les mappages de bandes
metadata/industry-schemaAucunCréer des filtres de hiérarchie sectorielle ou mapper les niveaux sectoriels
metadata/geography-schemaAucunCréer des filtres de hiérarchie géographique ou mapper des pays à des régions
metadata/available-datesAucunRetrouvez les dernières dates d’entrée en vigueur disponibles et définitives
Si vous prévoyez déjà d’agréger, de répartir par tranches, de trier ou de regrouper les données vous-même, privilégiez la route analytique plutôt que d’extraire des lignes getdata et de les reformater côté client.

Ordre de la requête

Chaque route analytique suit le même ordre :
  1. scope sélectionne l’univers d’entrée.
  2. La route calcule son résultat pour cet univers.
  3. result_filter reformate les lignes renvoyées.
scope.filters détermine quelles entités sont prises en compte dans l’analyse. result_filter.filters Ne filtre que les lignes renvoyées. Consultez la section « Portée et résultats vides» pour connaître les modèles et les cas limites. Pour metric et rating_scale, consultez Métriques et échelles. Pour les charges utiles de type « copier-coller », consultez Exemples de charges utiles.
Dernière modification le 10 juillet 2026