CVR API i PHP: opslag, søgning og fejlhåndtering

export FIRMAAPI_KEY="cvr_live_din_api_nøgle"

firmaapi.php

<?php
declare(strict_types=1);

final class FirmaApiException extends RuntimeException
{
    public function __construct(
        public readonly int $status,
        public readonly string $errorCode,
        string $message,
    ) {
        parent::__construct($status . ' ' . $errorCode . ': ' . $message);
    }
}

function erGyldigtCvr(string $input): bool
{
    $cifre = preg_replace('/\D/', '', $input);
    if (strlen($cifre) !== 8) {
        return false;
    }
    $vaegte = [2, 7, 6, 5, 4, 3, 2, 1];
    $sum = 0;
    foreach (str_split($cifre) as $i => $ciffer) {
        $sum += (int) $ciffer * $vaegte[$i];
    }
    return $sum % 11 === 0;
}

final class FirmaApi
{
    private const BASE_URL = 'https://firmaapi.dk/api/v1';

    public function __construct(
        private string $apiKey,
        private int $maxRetries = 3,
        private int $timeout = 10,
    ) {
    }

    public function request(string $method, string $path, array $query = [], ?array $body = null): array
    {
        $query = array_filter($query, static fn ($v) => $v !== null);
        $url = self::BASE_URL . $path . ($query ? '?' . http_build_query($query) : '');

        for ($forsoeg = 0; ; $forsoeg++) {
            $retryAfter = null;
            $headers = ['Authorization: Bearer ' . $this->apiKey, 'Accept: application/json'];

            $ch = curl_init($url);
            curl_setopt_array($ch, [
                CURLOPT_RETURNTRANSFER => true,
                CURLOPT_CUSTOMREQUEST => $method,
                CURLOPT_TIMEOUT => $this->timeout,
                CURLOPT_HEADERFUNCTION => function ($handle, string $line) use (&$retryAfter): int {
                    if (stripos($line, 'Retry-After:') === 0) {
                        $retryAfter = (int) trim(substr($line, 12));
                    }
                    return strlen($line);
                },
            ]);
            if ($body !== null) {
                $headers[] = 'Content-Type: application/json';
                curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body, JSON_THROW_ON_ERROR));
            }
            curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

            $raw = curl_exec($ch);
            if ($raw === false) {
                $fejl = curl_error($ch);
                if ($forsoeg < $this->maxRetries) {
                    sleep(2 ** $forsoeg);
                    continue;
                }
                throw new RuntimeException('Netværksfejl: ' . $fejl);
            }

            $status = (int) curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
            $data = json_decode((string) $raw, true);
            $data = is_array($data) ? $data : [];

            if ($status >= 200 && $status < 300) {
                return $data;
            }

            $fejl = $data['error'] ?? [];
            $kode = $fejl['code'] ?? 'UNKNOWN';
            $kanProevesIgen = ($status === 429 && $kode === 'RATE_LIMIT_EXCEEDED')
                || in_array($status, [502, 503], true);

            if ($kanProevesIgen && $forsoeg < $this->maxRetries) {
                sleep(max(1, $retryAfter ?? 2 ** $forsoeg));
                continue;
            }
            throw new FirmaApiException($status, $kode, $fejl['message'] ?? 'Ukendt fejl');
        }
    }

    public function virksomhed(string $cvr, ?string $include = null): array
    {
        return $this->request('GET', '/company/' . rawurlencode($cvr), ['include' => $include]);
    }

    public function soeg(string $q, string $status = 'Aktiv', int $limit = 10): array
    {
        return $this->request('GET', '/company/search', ['q' => $q, 'status' => $status, 'limit' => $limit]);
    }

    public function avanceretSoegning(array $filtre): array
    {
        return $this->request('GET', '/search/advanced', $filtre);
    }

    public function batch(array $cvrNumre): array
    {
        return $this->request('POST', '/company/batch', [], ['cvr_numbers' => array_values($cvrNumre)]);
    }
}

<?php
require __DIR__ . '/firmaapi.php';

$api = new FirmaApi(getenv('FIRMAAPI_KEY') ?: '');
$cvr = '24256790';

if (!erGyldigtCvr($cvr)) {
    exit("Ugyldigt CVR-nummer\n");
}

try {
    $v = $api->virksomhed($cvr);
    echo $v['name'] . ' (' . $v['status'] . '), ' . ($v['city'] ?? '') . "\n";
} catch (FirmaApiException $e) {
    match ($e->errorCode) {
        'NOT_FOUND' => print("CVR-nummeret findes ikke\n"),
        'MONTHLY_LIMIT_EXCEEDED' => print("Månedskvoten er brugt\n"),
        default => throw $e,
    };
}

// Find CVR-nummer ud fra et navn
$svar = $api->soeg('novo nordisk', 'Aktiv', 5);
foreach ($svar['results'] as $hit) {
    echo $hit['cvr'] . ' ' . $hit['name'] . "\n";
}

// Avanceret søgning med paginering
$offset = 0;
do {
    $side = $api->avanceretSoegning([
        'industry' => '62',
        'city' => 'Aarhus',
        'status' => 'Aktiv',
        'limit' => 100,
        'offset' => $offset,
    ]);
    foreach ($side['results'] as $v) {
        echo $v['cvr'] . ' ' . $v['name'] . "\n";
    }
    $offset += 100;
} while ($side['has_more']);

function hentMange(FirmaApi $api, array $cvrNumre, int $blok = 100): array
{
    $gyldige = array_values(array_filter(array_unique($cvrNumre), 'erGyldigtCvr'));
    $fundet = [];

    foreach (array_chunk($gyldige, $blok) as $gruppe) {
        $svar = $api->batch($gruppe);
        foreach ($svar['results'] as $v) {
            $fundet[$v['cvr']] = $v;
        }
        // $svar['errors'] indeholder numre, der ikke blev fundet
    }
    return $fundet;
}

function virksomhedMedCache(FirmaApi $api, string $cvr, int $ttl = 86400): array
{
    $fil = sys_get_temp_dir() . '/cvr_' . $cvr . '.json';
    if (is_file($fil) && time() - filemtime($fil) < $ttl) {
        return json_decode(file_get_contents($fil), true);
    }
    $data = $api->virksomhed($cvr);
    file_put_contents($fil, json_encode($data), LOCK_EX);
    return $data;
}