Send data til Energinet ved hjelp av vårt API

Denne artikkelen gir en kort oversikt over hvordan du bruker vårt API til å sende inn målerdata til Energinet.

API-et vårt

API-et vårt er et REST API, som følger RESTful-arkitekturstilen. Nedenfor finner du den informasjonen du trenger for å komme raskt i gang.

Begrensninger i API-et:

• Hver avsenderprofil har lov til å sende én forespørsel hvert 10. minutt.

• Maksimal størrelse på en datanyttelast er 0,5 MB.

• Maks 50 individuelle avsenderprofiler per import.

Sende data til Energinet

Det er enkelt å sende data til plattformen vår ved hjelp av API-et vårt. Følgende trinn vil veilede deg gjennom prosessen:

For å kunne opprette et API-token må du være systemadministrator for hele toppnivået du legger til importen på.

1. Opprett en ny API-import i Energinet (i innstillingsmenyen). Det er viktig å velge hvilken del av trestrukturen importen skal gjelde for.

2. Legg til en avsender i Energinet. Du vil da få tilgang til API-tokenet for denne avsenderen. Du kan ha opptil 50 individuelle avsendere i én import.

3. Send inn data i JSON-format (se eksempel nedenfor); du må foreta autoriserte anrop til Energinets API. Autorisering gjøres med bærertoken. Et slikt token (løs kode) plasseres i autorisasjonsoverskriften til http-anropet til API-et på følgende måte:Authorization: Bearer [token] ([token] skal erstattes med ditt token).

4. API-et har ett endepunkt for innsending av målerdata:https://www.energinet.net/apiImport/data.

5. Dataene er utformet som en liste med målere/verdisett og tilhørende verdier. Hver måler/verdisett må ha en meterID definert som en importidentifikator i måleroppsettet i Energinet. Det må også være en dateTime som følger ISO8106.  Feltet value kan kun være et flyttall.

Eksempel på innsending av data:

URL: https://www.energinet.net/apiImport/data
Method: POST
Headers:
Authorization: Bearer [token]
Content-Type: applikation/json
Accept: applikation/json

Eksempel på payload:

[
 	{
 		"meterID": "7777777777",
 		"values": [[
			"2023-02-02T01:00", 
			45
		],[
			"2023-02-02T02:00",
			46
		]]
 	},
 	{	
		"meterID": "6666666666", 
		"values": [[
			"2023-02-02T01:00",
			34
		],[
			"2023-02-02T02:00",
			23.44
		]]
 	}
]

Eksempel på respons:

Headers:
HTTP/1.1 200 OK
Content-Type: application/json
[
	{
 		"meterID": "7777777777",
 		"number_of_values": 2,
 		"status": 201
 	},
 	{
 		"meterID": "6666666666",
 		"number_of_values": 2,
 		"status": 201
 	}
]