...
| Table of Contents | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
1. Client secret
Hvis I kender jeres "Client Id/Client secret" så spring dette step over!
...
❗ Vær opmærksom på, at forskellige roller kræver særskilte client secrets. F.eks. har man et client secret for en elleverandør, så kan dette client secret IKKE benyttes til handlinger hvor elleverandør rollen ikke må foretage disse handlinger. Hver rolle kræver altså deres eget client secret.
2. Bearer token
Kald endpoint for at få udleveret bearer token
| Panel | ||
|---|---|---|
| ||
PREPROD[POST] https://login.microsoftonline.com/20e7a6b4-86e0-4e7a-a34d-6dc5a75d1982/oauth2/v2.0/token [Required Header] [Body] PROD[POST] https://login.microsoftonline.com/4b8c3f88-6cca-480c-af02-b2d2f220913f/oauth2/v2.0/token [Required Header] [Body] |
...
Vær opmærksom på, at bearer token har en kort levetid på 1 time.
3. Kald DataHub
NotifyAggregated MeasureData RSM-014 og Notifywholesaleservices RSM-019
| Panel | ||
|---|---|---|
| ||
PREPROD: [GET] https://preprod.b2b.datahub3.dk/v1.0/cim/aggregations PROD: [GET] https://b2b.datahub3.dk/v1.0/cim/aggregations [Find url på denne side: Dokumenttype og deres relation til kø’er og endpoint. - DataHub Docs & DX - Confluence [Required Header] |
...
Dequeue
| Panel | ||
|---|---|---|
| ||
PREPROD: [DELETE] https://preprod.b2b.datahub3.dk/v1.0/cim/dequeue/{message-id} PROD: [DELETE] https://b2b.datahub3.dk/v1.0/cim/dequeue/{message-id}Find url på denne side: Dokumenttype og deres relation til kø’er og endpoint. - DataHub Docs & DX - Confluence [Required Header] |
...
Request aggregated measure data RSM-016
| Panel | ||
|---|---|---|
| ||
PREPROD: [POST] https://preprod.b2b.datahub3.dk/v1.0/cim/requestaggregatedmeasuredata PROD: [POST] https://b2b.datahub3.dk/v1.0/cim/requestaggregatedmeasuredata [Find url på denne side: Dokumenttype og deres relation til kø’er og endpoint. - DataHub Docs & DX - Confluence [Required Header] [Body] |
...
Request wholesale settlementdata RSM-017
| Panel | ||
|---|---|---|
| ||
PREPROD: [POST] https://preprod.b2b.datahub3.dk/v1.0/cim/requestwholesalesettlement PROD: [POST] https://b2b.datahub3.dk/v1.0/cim/requestwholesalesettlementFind url på denne side: Dokumenttype og deres relation til kø’er og endpoint. - DataHub Docs & DX - Confluence [Required Header]
[Body] |
...
Krævet rolle (én af disse roller skal være udstillet fra token der benyttes) |
|---|
energysupplier |
delegated |
systemoperator |
gridaccessprovider |
4. Postman collection
Vi har lavet en postman collection der tager udgangspunkt i ovenstående, som kan hjælpe dig med at komme hurtigt igang.
...
| View file | ||
|---|---|---|
|
5. .NET eksempel
Du kan finde inspiration i vores acceptance test til hvordan du kan oprette en C# http client, som kan kommuniker med DataHub 3 ud fra ovenstående. Repositoriet kan findes her: https://github.com/Energinet-DataHub/opengeh-edi/tree/main/source/AcceptanceTests/Tests.
Selve kommunikationen med DataHub 3 sker her: https://github.com/Energinet-DataHub/opengeh-edi/blob/main/source/AcceptanceTests/Drivers/EdiDriver.cs
6. Logning
Alle Http svar fra DataHub vil have en header som hedder ‘correlationId’ som man ville kunne referer til ved kald som fejler, det kunne være til en stor hjælp at hvis der opstod fejl i takt med kommunikation med DataHub, at man loggede ‘correlationId’ sammen med en tilhørende fejlbesked for at vi nemmere kan supporter henvendelser.
7. Samlet oversigt
Der findes en samlet oversigt over