Datafordeler GraphQL klient

Denne klient gør det nemt at hente data fra Datafordelerens GraphQL tjenester.

| ⚠️ | Klienten er under aktiv udvikling og er ikke stabil. Brug af klienten er på eget ansvar, vi garanterer ikke at den virker korrekt. | | --- | -------------------------------------------------------------------------------------------------------------------------------------- |

Hurtigt eksempel

Her er et fuldt eksempel på hvordan klienten bruges:

Den første fil bygger en query:

import { buildQuery } from "daf-graphql-client/build.js";
import { MAT_SamletFastEjendom } from "daf-graphql-client/v1/MAT/SamletFastEjendom/seed.js";
import { MAT_MatrikulærtElementStatus } from "daf-graphql-client/v1/MAT/types.js";
import { LongVariable } from "daf-graphql-client/variables.js";

// Byg en query som kan hente en SFE's lokalId og seneste sags lokalId
export const sfeQuery = buildQuery(MAT_SamletFastEjendom, {
	filter: {
		status: { eq: MAT_MatrikulærtElementStatus.Gældende },
		BFEnummer: { eq: LongVariable("bfe") },
	},
	fields: {
		id_lokalId: true,
		senesteSagLokalId: true,
	},
});

Den næste fil bruger den byggede query til at hente data fra Datafordeleren:

import { sfeQuery } from "./bygQuery.js";
import { QueryFetcher } from "daf-graphql-client/fetch.js";
import { ApiKeyAuthenticator } from "daf-graphql-client/authentication.js";
import type { QueryFetchConfiguration } from "daf-graphql-client/types.js";

// Start en klient med den angivne query og den variabel som vi byggede ind
const sfeQueryClient = new QueryFetcher(sfeQuery, {
	authentication: new ApiKeyAuthenticator("..."), // indsæt din API nøgle til Datafordeleren her
	variables: {
		bfe: 000000, // vælg et BFE-nummer at prøve med her
	}
});

// Du kan løbende logge resultaterne imens de hentes
for await (const SFE of sfeQueryClient.streamInstances()) {
	console.log(SFE);
}

// Eller du kan vente på at de alle sammen er hentet
const SFEs = await sfeQueryClient.getInstances();
console.log(SFEs);

// Du kan hente alle SFEer bortset fra den første og sidste
const mostSFEs = await sfeQueryClient.getInstances({start: 1, end: -1});
console.log(mostSFEs);

// Du kan også bare hente den første SFE hvis du ved at der ikke er andre
const sfe = await sfeQueryClient.getInstance({nullable: true});
console.log(sfe);

Autentificering

Se hvordan du autentificerer din klient med datafordeleren her: autentificering.md.

Registeroversigt

Se hvilke registre klienten understøtter: registre.md.