Siden beskriver GraphQL, der udstilles på Datafordeleren fra CVR.

Få en introduktion til GraphQL på Datafordeleren, hvis du har brug for en generel og mere teknisk indføring i GraphQL på Datafordeleren.

Læs mere om Anmodning om adgang til beskyttede registerdata, hvis du skal have adgang til registrets adgangsbegrænsede entitet CVRPerson.





Generelt for CVR GraphQL 


Version for GraphQLv2
Version for GraphQL Customv1
Sikkerhedszone

0 – Indeholder ikke fortrolige eller følsomme data

5 –  Indeholder fortrolige eller følsomme data

Adgangsniveau

API-key, OAuth Shared Secret eller OAuth Certifikat

GraphQL skemaerhttps://graphql.datafordeler.dk/CVR/<version>/schema?
https://graphql.datafordeler.dk/CVR/custom/<version>/schema?
Endepunkter for CVR

https://graphql.datafordeler.dk/CVR/<version>
https://graphql.datafordeler.dk/CVR/custom/<version> 
Dato- og tidsformat

Datoformat følger ISO 8601 Date and time format.

Alle datoer skrives med andre ord i formatet yyyy-mm-ddTHH:MM:SS.ssssss, hvor tidsangivelsen kan udelades.

UTC kan angives enten ved +HH:MM (2019-07-05T07:50:14.687580+01:00) eller ved at benytte Z (2019-07-05T07:50:14.687580Z)

Entiteter

Registret har følgende entiteter:

  • Adressering
  • AndreDeltagere
  • AnsvarligDataleverandoer
  • Beskaeftigelse
  • Branche
  • CVREnhed
  • CVRPerson (kræver godkendt adgang)
  • e_mailadresse
  • FuldtAnsvarligDeltagerRelation
  • Kreditoplysninger
  • Navn
  • Produktionsenhed
  • Reklamebeskyttelse
  • Telefaxnummer
  • Telefonnummer
  • Virksomhed
  • Virksomhedsform

Custom entiteter:

  • CVRPersonBegraenset

Læs mere om registrets entiteter i objekttypekataloget





Specialudviklet GraphQL-tjeneste for CVR


Entiteten CVRPerson fra CVR har et enkelt felt som indeholder adgangsbegrænsede data, mens resten af felterne ikke er adgangsbegrænsede. Datafordeleren udstiller derfor den specialudviklede entitet CVRPersonBegraenset gennem en GraphQL-tjeneste, der giver anvendere mulighed for at hente en ikke-adgangsbegrænset udgave af entiteten CVRPerson. Entiteten CVRPersonBegraenset er identisk med CVRPerson bortset fra at feltet CPRPerson er fjernet.

Filtreringsmulighederne på CVRPersonBegraenset-entiteten er de samme som tillades på CVRPerson-entiteten, bortset fra at det ikke er muligt at filtrere på CPRPerson-feltet. GraphQL-skemaet ligner det for CVRPerson-entiteten, dog uden CVRPerson-feltet.

Tjenesten er tilgængelig på følgende URL:

https://graphql.datafordeler.dk/CVR/custom/<version>




CVR Custom

Der er lavet en specialudviklet entitet for CVR's Person-entitet, navngivet CVRPersonBegraenset, for de anvendere som har brug for adgang til denne data, men som ikke har hjemmel til at se personens CPR-nummer.

CVRPersonBegraenset entiteten har sin helt egen tjeneste og tilgås på url’en https://graphql.datafordeler.dk/CVR/custom/v1.

Tjenesten kaldes på præcis samme måde som du ville kalde CVR's standard entitetsbaserede tjeneste, og har sit eget skema som kan bruges i en GraphQL API Client til at udforme valide forespørgsler.



Fleksibel opslagslogik


Se hvilke relationer registret har i deres fleksibel opslagslogik-skema.

Se vejledning til fleksibel opslagslogik på følgende sider