API de calcul tarifaire gaz et électricité

En bref

• Calcul unitaire : un appel POST /api/v1/simulator/calculate/ renvoie le calcul d'un site gaz (PITD, LI, PIC) ou électricité (TURPE, TURPE_HTB).
• Authentification : une clé API par organisation, transmise dans l'en-tête HTTP X-API-Key.
• Limite : 60 requêtes par minute et par clé.
• Documentation : Swagger public sur api.energydataplatform.fr/api/docs/.
• Offre : l'API REST figure dans l'offre Enterprise de la grille tarifaire.

Cas d'usage pour un cabinet de courtage

Endpoints disponibles

L'API v1 comprend six endpoints, tous authentifiés par clé API. La liste ci-dessous correspond à la documentation Swagger publique.

• POST /api/v1/simulator/calculate/

  Calcul tarifaire d'un site : gaz (PITD, LI, PIC) ou électricité (TURPE, TURPE_HTB). Réponse structurée uniquement, sans PDF ni session.

• POST /api/v1/batch-calc/jobs/

  Calcul en lot à partir d'un CSV (fichier multipart « file » ou texte « csv » dans un corps JSON), jusqu'à 200 lignes par envoi. Traitement synchrone.

• GET /api/v1/batch-calc/jobs/{job_id}/

  Statut d'un lot (queued, running, done, failed) et nombre de lignes traitées ou en erreur. Lot introuvable s'il n'appartient pas à l'organisation de la clé.

• POST /api/v1/brokerage/compare/

  Comparaison des offres fournisseurs référencées dans EDP pour un profil (type d'énergie + consommation annuelle en MWh, ou profil énergétique existant). Économie calculée si le coût annuel actuel est fourni.

• GET /api/v1/contracts/monitoring/

  Indicateurs du portefeuille de contrats en cours de l'organisation : nombre, coût et consommation annuels, contrats arrivant à échéance sous 90 jours, alertes d'échéance à 180 jours.

• GET /api/v1/usage/

  Consommation de la clé : limite par minute, appels de la minute en cours, appels par endpoint sur 30 jours, date du dernier appel.

Authentification et limites de débit

Exemple : calcul d'un site gaz PITD

Requête avec les champs acceptés par l'endpoint : point de livraison, code PITD du site, tarif, profil et consommation annuelle de référence (car, en MWh/an). Le champ dateEffetMonth est optionnel. L'en-tête Content-Type: application/json est obligatoire.

curl -X POST https://api.energydataplatform.fr/api/v1/simulator/calculate/ \
  -H "X-API-Key: $EDP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "pointDeReseau": "PITD",
    "code": "<code PITD du site>",
    "tarif": "T2",
    "profil": "P014",
    "car": 150,
    "dateEffetMonth": "2026-01"
  }'

Structure de la réponse (extrait, valeurs omises) :

{
  "organisation": "slug-de-votre-cabinet",
  "pointDeReseau": "PITD",
  "result": {
    "abonnementA": ...,
    "termeProportionnelA": ...,
    "totalCtaA": ...,
    "ticgnA": ...,
    "totalA": ...,
    "miseAJourTarifaireDu": "...",
    ...
  }
}

Pour un site PITD, totalA est le coût annuel d'acheminement et de taxes, hors part fourniture et hors TVA. Le contenu de result varie selon le point de livraison. Un champ warnings peut signaler une combinaison tarif / profil inhabituelle, sans bloquer le calcul.

Quelle offre inclut l'API ?

Limites actuelles

• Calcul en lot : 200 lignes maximum par envoi via l'API et fichier de 5 Mo maximum. Au-delà, découpez le fichier.
• Traitement synchrone : la réponse revient une fois le lot calculé.
• Le moteur calcule les composantes régulées (acheminement, CTA et, selon le point de livraison, taxes). Le prix de fourniture négocié n'est pas calculé.
• L'endpoint de comparaison fournisseurs renvoie les offres référencées dans EDP ; le comparateur fournisseurs est annoncé « à venir » dans la grille tarifaire.
• Pas de webhook : votre outil interroge l'API à son initiative.

Questions fréquentes sur l'API

Autres questions sur EDP : FAQ complète.