Vejledning til API

Fra 14. april 2026 stiller EU krav til udstilling af API efter datamodel DATEX-II, jf. gennemførelsesforordning 2025/655 af 2. april 2025. Det betyder, at dynamiske og statiske data om offentligt tilgængelige ladepunkter og tankstandere for alternative drivmidler skal udstille i det API-format, som følger heraf.

DATA-udveksling

(Applikations-programmeringsgrænseflade, API)

Valget om at anvende dataformatet DATEX II til API’er, der skal tilgængeliggøre data fra den 14. april 2026, er truffet for at sikre en standardiseret datadeling på tværs af EU. Med implementeringen af AFIR i hele EU forventes branchestandarder for dataudveksling i højere grad at blive tilpasset de krav, som AFIR stiller. Samtidig er markedet for alternative drivmidler i konstant udvikling. For at sikre, at data om alternative drivmidler i Danmark følger denne udvikling, skal API-formatet derfor være i DATEX II.

Til internt brug kan branchestandarden OCPI anvendes med henblik på konvertering af data til DATEX II-format ved tilgængeliggørelse på NAP. Branchestandarden bør være i den nyeste version eller – i en overgangsperiode – i versionen umiddelbart før den nyeste for at være i overensstemmelse med kravene til datatyper i AFIR.

  • For data om opladning af elbiler og andre eldrevne køretøjer til internt brug anbefales den nyeste version af Open Charge Point Interface (OCPI) som branchestandard for at være i overensstemmelse med kravene til datatyper i AFIR. Ved anvendelse af OCPI skal data konverteres til DATEX II for at kunne gøres tilgængelige.
  • For optankning med biogas, skal data gøres tilgængelig som den nyeste version af API efter branchestandarden for dataudveksling.
  • For optankning med brint, skal data gøres tilgængelig som den nyeste version af API efter branchestandarden for dataudveksling.

Tekniske specifikationer

API for data af offentlig tilgængelige ladepunkter

 

For DATEX-II skal følgende informationer oplyses på Dataudveksleren, for at efterleve AFI-forordningens krav omkring API:

  • IDRO
  • Oplysning om CREDENTIALS_TOKEN_A
  • Versions endpoint; url til produktionsmiljø
  • Frivilligt: oplysninger om adgang til testmiljø

OCPI-specifikation til intern brug

  • OCPI-version: Fra december 2024 er OCPI 2.2.1 den nyeste version.
  • Data skal følge OCPI specifikationen.

Der gøres opmærksom på, at Færdselsstyrelsen ikke leverer konverteringsværktøjer eller tekniske mellemled mellem eksisterende branchestandarder som f.eks. OCPI til DATEX II. Der stilles som minimum krav til DATEX-II format, angivet i AFIR.

Kommissionens delegerede retsakter er blevet forsinkede i sin vedtagelsesproces. Af denne grund er det kravene til tilgængeliggørelse af datatyper i AFI-forordningens artikel 20, stk. 2, som påkræves gjort tilgængelig pr. 14. april 2025. For at minimere hvor mange gange, operatører skal ændre datatilgængeliggørelsen, opfordrer Færdselsstyrelsen til at opfylde datakravene i de delegerede retsakter på trods af deres forsinkede vedtagelse.

API for biogasdata

  • Oplysninger om adgang til API
  • Versions endpoint; url til produktionsmiljø
  • Frivilligt: oplysninger om adgang til testmiljø

Krav til data

AFI-forordningen stiller krav til hvilke data der skal udstilles via API’en, men det fremgår ikke tydeligt, hvordan de listede data skal udstilles. I retsakterne til AFIR, som på nuværende tidspunkt er i høring, bliver dataindholdet beskrevet mere uddybende end i forordningen. Færdselsstyrelsen vil, når retsakterne er vedtaget, tilføje en specificering til denne vejledning om; hvordan styrelsen anbefaler at API branchestandarden følges for på bedst mulig måde at overholde krav til data beskrevet i retsakterne til AFIR. Ved at følge disse anbefalinger, bliver data mere ensartet, og sikrer en bedre, overordnet datakvalitet.

Information om ændringer og udvikling

Som beskrevet ovenfor, er kravet til dataudveksling, at det følger udviklingen i branchestandarder og krav fra EU. For at få information om ændringer og udvikling i krav til dataudveksling, anbefales det at følge med på Færdselsstyrelsens hjemmeside, og som operatør eller ejer af infrastruktur for alternative drivmidler at skrive sig på Færdselsstyrelsens mailingliste for operatører og ejer af infrastruktur for alternative drivmidler. Du kan tilmelde dig nyhedsbrevet nederst på siden.

Der vil komme information ved skift af API version for branchestandard og forventede paralleldriftsperiode. Ligeledes vil der blive kommunikeret omkring ændringer til krav og anbefalinger til dataindhold.

Monitorering og evaluering

Færdselsstyrelsen følger løbende med i overholdelse af AFIR både i forhold til adgang til data, krav til API og datas opfyldelse af AFIR bestemmelser og evaluerer status for hver operatør eller ejer af infrastruktur for alternative drivmidler.

Yderligere og hjælp og vejledning

Herunder finder du guiden til dataformatet samt kontaktoplysninger til Vejdirektoratet, som kan vejlede i tekniske spørgsmål vedr. dataudveksleren.

Har du spørgsmål til AFI-forordningen og retsakter, bedes disse rettes til Færdselsstyrelsen via info@fstyr.dk

Modtag seneste nyt om AFIR

Tilmeld dig nyhedsmailen