Id Referential (V2)

Documentation

La documentation est disponible ici

Configuration Data Hub

Sources

Créez une source DataHub par EIC que vous souhaitez interroger.

Tip

EIC signifie Energy Identification Code (code d’identification de point d’énergie normalisé ENTSO-E).
Exemple de format : 99XFR-XXXXXXXX-XX.

Paramétrage recommandé par source :

Propriété Valeur / Règle
Type de source Rte
Type d’énergie Electricité
Fuseau horaire UTC
MeterNumber Code EIC du point à interroger
Nom / Description Libre (utilisez idéalement un nom parlant incluant l’EIC)
Important

La validité de l’EIC dans MeterNumber conditionne directement la qualité des résultats (service points trouvés, services découverts, etc.).

Comprendre les endpoints

L’API Id Referential (V2) renvoie une cartographie des capacités RTE par point.
Vous n’avez pas besoin de connaître les détails HTTP : retenez la structure logique et à quoi elle sert.

Structure logique de réponse

ServicePoints
 └─ DataServices
     └─ Apis
  • ServicePoints : les “points” connus pour l’EIC donné (ex. périmètres, sites, comptages logiques).
  • DataServices : familles de services RTE disponibles pour le point (ex. Big Adjusted, Mesures, Prévisions…).
  • Apis : endpoints concrets exposés dans chaque DataService (ex. /v2/measurements, /v2/big-adjusted/initial, etc.).
Note

Le gestionnaire lit cette structure pour compter (et tracer) combien d’APIs sont disponibles par point.
Aucune donnée n’est écrite dans DataHub : c’est un outil d’inventaire/éligibilité.

Usage côté DataHub

Ce que fait le module

  • Parcourt vos sources RTE (une par EIC).
  • Interroge Id Referential (V2) pour chaque source.
  • Journalise ce qui est disponible (nb de service points / data services / apis).
  • Remonte les erreurs par source (ex. EIC invalide, indisponibilité, droits).

Ce que vous devez prévoir

  • Créer les sources avec le bon EIC (voir tableau plus haut).
  • Vérifier les logs pour confirmer :
    • que l’EIC renvoie des service points,
    • quels data services sont visibles,
    • quels endpoints API sont listés (donc théoriquement utilisables).
Tip

Utilisez ce module avant de configurer des collectes (ex. Big Adjusted, Mesures temps réel) afin de valider l’éligibilité sur chaque EIC.
Si un service attendu n’apparaît pas, vérifiez l’EIC, les droits et la disponibilité côté RTE.

Fréquence & planification

  • L’API Id Referential (V2) est une API de découverte : elle s’appelle à la demande.

Résultats attendus dans les logs

  • Succès (par source) :
    « Retrieved N service points for source Id(X), MeterNumber ‘EIC’ »
  • Échec (par source) :
    « Call to IdReferential.V2 failed … Reason: message d’erreur »
Tip

Conservez un journal quotidien : cela permet de repérer rapidement l’apparition/disparition d’un service côté RTE et d’ajuster vos collectes.