CVR API i Node.js: opslag, søgning og fejlhåndtering

export FIRMAAPI_KEY="cvr_live_din_api_nøgle"

// firmaapi.mjs
const BASE_URL = "https://firmaapi.dk/api/v1";

export class FirmaApiError extends Error {
  constructor(status, code, message) {
    super(status + " " + code + ": " + message);
    this.name = "FirmaApiError";
    this.status = status;
    this.code = code;
  }
}

export function erGyldigtCvr(input) {
  const cifre = String(input).replace(/\D/g, "");
  if (cifre.length !== 8) return false;
  const vaegte = [2, 7, 6, 5, 4, 3, 2, 1];
  const sum = [...cifre].reduce((s, c, i) => s + Number(c) * vaegte[i], 0);
  return sum % 11 === 0;
}

const vent = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

export class FirmaApi {
  constructor({ apiKey = process.env.FIRMAAPI_KEY, maxRetries = 3, timeoutMs = 10000 } = {}) {
    if (!apiKey) throw new Error("FIRMAAPI_KEY mangler");
    this.apiKey = apiKey;
    this.maxRetries = maxRetries;
    this.timeoutMs = timeoutMs;
  }

  async request(path, { method = "GET", query = {}, body } = {}) {
    const url = new URL(BASE_URL + path);
    for (const [navn, vaerdi] of Object.entries(query)) {
      if (vaerdi !== undefined && vaerdi !== null) url.searchParams.set(navn, String(vaerdi));
    }

    for (let forsoeg = 0; ; forsoeg++) {
      const res = await fetch(url, {
        method,
        headers: {
          Authorization: "Bearer " + this.apiKey,
          ...(body ? { "Content-Type": "application/json" } : {}),
        },
        body: body ? JSON.stringify(body) : undefined,
        signal: AbortSignal.timeout(this.timeoutMs),
      });

      if (res.ok) return res.json();

      const fejl = (await res.json().catch(() => ({}))).error ?? {};
      const kode = fejl.code ?? "UNKNOWN";
      const kanProevesIgen =
        (res.status === 429 && kode === "RATE_LIMIT_EXCEEDED") ||
        res.status === 502 ||
        res.status === 503;

      if (kanProevesIgen && forsoeg < this.maxRetries) {
        const sekunder = Number(res.headers.get("Retry-After")) || 2 ** forsoeg;
        await vent(sekunder * 1000);
        continue;
      }
      throw new FirmaApiError(res.status, kode, fejl.message ?? res.statusText);
    }
  }

  virksomhed(cvr, include) {
    return this.request("/company/" + encodeURIComponent(cvr), { query: { include } });
  }

  soeg(q, { status = "Aktiv", limit = 10 } = {}) {
    return this.request("/company/search", { query: { q, status, limit } });
  }

  avanceretSoegning(filtre) {
    return this.request("/search/advanced", { query: filtre });
  }

  batch(cvrNumre) {
    return this.request("/company/batch", { method: "POST", body: { cvr_numbers: cvrNumre } });
  }
}

import { FirmaApi, FirmaApiError, erGyldigtCvr } from "./firmaapi.mjs";

const api = new FirmaApi();
const cvr = "24256790";

if (!erGyldigtCvr(cvr)) {
  throw new Error("Ugyldigt CVR-nummer");
}

try {
  const v = await api.virksomhed(cvr);
  console.log(v.name, v.status, v.city);
} catch (err) {
  if (err instanceof FirmaApiError && err.code === "NOT_FOUND") {
    console.log("CVR-nummeret findes ikke");
  } else if (err instanceof FirmaApiError && err.code === "MONTHLY_LIMIT_EXCEEDED") {
    console.log("Månedskvoten er brugt");
  } else {
    throw err;
  }
}

// Find CVR-nummer ud fra et navn
const { results } = await api.soeg("novo nordisk", { limit: 5 });
for (const hit of results) console.log(hit.cvr, hit.name, hit.city);

// Gennemløb alle sider af en avanceret søgning
async function* alleHit(filtre) {
  let offset = 0;
  while (true) {
    const side = await api.avanceretSoegning({ ...filtre, limit: 100, offset });
    yield* side.results;
    if (!side.has_more) return;
    offset += 100;
  }
}

for await (const v of alleHit({ industry: "62", city: "Aarhus", status: "Aktiv" })) {
  console.log(v.cvr, v.name);
}

async function hentMange(api, cvrNumre, blok = 100) {
  const gyldige = [...new Set(cvrNumre)].filter(erGyldigtCvr);
  const fundet = new Map();

  for (let i = 0; i < gyldige.length; i += blok) {
    const svar = await api.batch(gyldige.slice(i, i + blok));
    for (const v of svar.results) fundet.set(v.cvr, v);
    // svar.errors indeholder numre, der ikke blev fundet
  }
  return fundet;
}

// app/api/virksomhed/[cvr]/route.ts (Next.js)
import { FirmaApi, FirmaApiError, erGyldigtCvr } from "@/lib/firmaapi.mjs";

const api = new FirmaApi();

export async function GET(_req: Request, { params }: { params: Promise<{ cvr: string }> }) {
  const { cvr } = await params;
  if (!erGyldigtCvr(cvr)) {
    return Response.json({ fejl: "Ugyldigt CVR-nummer" }, { status: 400 });
  }
  try {
    const v = await api.virksomhed(cvr);
    return Response.json({ cvr: v.cvr, navn: v.name, status: v.status, by: v.city });
  } catch (err) {
    if (err instanceof FirmaApiError && err.status === 404) {
      return Response.json({ fejl: "Findes ikke" }, { status: 404 });
    }
    return Response.json({ fejl: "Opslaget fejlede" }, { status: 502 });
  }
}