💀💀💀 This lib is no longer maintained 💀💀💀 see aeneria-app#51 to read more about it
Firstly developped to be used in aeneria, this small library let you use easily Enedis Data Connect API.
PHP 8.1 or higher
First of all, you will need a ClientID and a ClientSecret to use Enedis Data Connect API. Visit https://datahub-enedis.fr/data-connect, to know how to get ones. During your registration you will also give a redirect URL, you will need it touse this library.
Now that you have those, install the library with composer:
composer require aeneria/enedis-data-connect
If you are using a framework such as Symfony, you can declare the library as a service and use it with dependency injection:
# config/services.yaml
services:
Aeneria\EnedisDataConnectApi\Service\DataConnectService:
class: Aeneria\EnedisDataConnectApi\Service\DataConnectService
arguments:
$httpClient: "@http_client"
$authEndpoint: "https://mon-compte-particulier.enedis.fr"
$tokenEndpoint: "https://gw.prd.api.enedis.fr "
$dataEndpoint: "https://gw.prd.api.enedis.fr"
$clientId: "YOUR_CLIENT_ID"
$clientSecret: "YOUR_CLIENT_SECRET"
$redirectUri: "YOUR_REDIRECT_URI"
Or you can declare it in your code this way:
<?php
use Aeneria\EnedisDataConnectApi\Service\DataConnectService;
//...
$dataConnect = new DataConnectService(
HttpClient::create(),
"https://mon-compte-particulier.enedis.fr",
"https://gw.prd.api.enedis.fr "
"https://gw.prd.api.enedis.fr",
"YOUR_CLIENT_ID",
"YOUR_CLIENT_SECRET",
"YOUR_REDIRECT_URI
);
//...
Then you can use the API:
<?php
// Getting consent page URL
$dataConnect->getAuthorizeV1Service()->getConsentPageUrl('P6M', $state);
// Getting Tokens form Code
$token = $dataConnect->getAuthorizeV1Service()->requestAuthorizationToken();
// Getting consumption data
$meteringData = $dataConnect->getMeteringDataV5Service()->requestDailyConsumption(
$token->getAccessToken(),
$token->getUsagePointsId(),
new \DateTimeImmutable('8 days ago'),
new \DateTimeImmutable('yesterday')
);
$meteringData = $dataConnect->getMeteringDataV5Service()->requestConsumptionLoadCurve(
$token->getAccessToken(),
$token->getUsagePointsId(),
new \DateTimeImmutable('2 days ago'),
new \DateTimeImmutable('yesterday')
);
// Getting customer data
$address = $dataConnect->getCustomersV5Service()->requestUsagePointAdresse(
$token->getAccessToken(),
$token->getUsagePointsId()
);
Feel free to open an issue!