MatchPilot API og webhooks
Opdateret 20. november 2026
API'et forbinder dit konsulenthus med et CRM, et regneark eller en automatisering. Ejere og administratorer opretter nøgler under Indstillinger → Integrationer. En nøgle tilhører ét hus og virker kun, mens skaberen fortsat er ejer eller administrator i huset. Den giver ikke adgang til Nordic Tenders konsulenter, mails, kunder, kontrakter, økonomi eller noter.
Nøgler og adgange
Nøglen vises én gang. Gem den som en hemmelighed i det system, der kalder API'et, aldrig i en browser eller et offentligt kodearkiv. Send den i Authorization: Bearer. Tilbagekald nøglen under Integrationer for at stoppe forbindelsen. Kaldeloggen viser de seneste 50 kald og deres status.
consultants:read: læs husets konsulenter.consultants:write: opret/opdatér konsulenter og importér CV'er.assignments:read: læs åbne offentlige opgaver og husets egne opgaver.assignments:write: opret husets egne opgaver.matches:read: læs matchscore og begrundelse.cvs:read: hent et kortlivet link til en af husets CV-filer.
Endepunkter
| Metode og adresse | Indhold |
|---|---|
| GET /consultants | Husets konsulenter med total, limit og offset. |
| POST /consultants | Opret eller opdatér med external_id. |
| PATCH /consultants | Ret eksisterende external_id; udeladte felter bevares. |
| GET /assignments | To paginerede lister: market og own. |
| POST /assignments | Opret egen opgave med external_id og title. |
| GET /matches | Præcis én af assignment_id eller consultant_id; score, summary, parts og missing. |
| POST /cvs | Importér PDF/DOCX: external_id, file_name, base64. |
| GET /cvs | consultant_id giver et downloadlink gyldigt i 120 sekunder. |
Alle adresser starter med https://matchpilot.dk/api/integrations/v1. Konsulentopdateringer er afgrænset til husets external_id. Låste felter bevares. Samme mail på en anden profil giver 409 frem for en automatisk sammenlægning. Samtidige oprettelser med samme external_id kan give 409; hent profilen og prøv opdateringen igen.
Eksempler i curl
curl 'https://matchpilot.dk/api/integrations/v1/consultants?limit=25&offset=0' \
-H "Authorization: Bearer $MATCHPILOT_API_KEY"
curl 'https://matchpilot.dk/api/integrations/v1/consultants' \
-H "Authorization: Bearer $MATCHPILOT_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"external_id":"crm-123","full_name":"Anna Eksempel","title":"Azure-arkitekt","email":"anna@example.com"}'JavaScript på serveren
const response = await fetch(
'https://matchpilot.dk/api/integrations/v1/matches?consultant_id=' + consultantId,
{ headers: { Authorization: 'Bearer ' + process.env.MATCHPILOT_API_KEY } }
);
if (!response.ok) throw new Error('MatchPilot HTTP ' + response.status);
const { data, total } = await response.json();
for (const match of data) console.log(match.score, match.summary);Paginering og fejl
Brug limit mellem 1 og 100 og offset fra 0. Standard er 25. Opgavesvaret har separate lister for offentligt marked og egne opgaver; hent næste side af begge med det samme offset. Match rangeres før paginering. Der er højst 60 API-kald pr. minut pr. nøgle. Ved 429 angiver Retry-After, hvor mange sekunder du skal vente.
401: ugyldig/tilbagekaldt nøgle eller mistet ejerskab. 403: manglende scope. 404: posten findes ikke i det tilladte område. 409: dublet, konflikt eller låste CV-felter. 413: fil/request for stor. 422: ugyldigt indhold eller parametre. 429: for mange kald. 500/503: midlertidig fejl; brug backoff. Svar indeholder en kort maskinlæsbar error-kode.
CV'er og regneark
CV-endepunktet bruger samme parser som husets CV-upload. Send PDF eller DOCX som base64, højst 20 MB før kodning. En fil uden et genkendeligt konsulent-CV afvises. Før CV-felterne ændres, kontrolleres manuelle låse. CSV/XLSX kan importeres på integrationssiden med arkvalg, valg af kolonneoverskrifter og forhåndsvisning. Højst 1.000 datarækker og 5 MB pr. regneark. Mulige navnedubletter springes over og vises pr. række; eksisterende external_id kan opdateres. Eksport understøtter valgte kolonner og neutraliserer regnearksformler.
Webhooks
Vælg hændelser og en matchgrænse under Integrationer. Ny konsulent, ændret budstatus, ny opgave med stærkt match og frister kan lægges i husets leveringskø. Stærkt match betyder score over den valgte grænse. Signaturen er HMAC-SHA256 over timestamp.body med den særskilte webhook-hemmelighed, som vises én gang.
Godkendte modtagere er Slack, Teams, Zapier, Make og webhook.site. HTTPS er påkrævet; lokale/private adresser, brugeroplysninger i URL og redirects afvises. Egne domæner er endnu ikke aktiveret. Brug fx Zapier eller Make til at mappe hændelser til HubSpot/Pipedrive-felter eller en Slack/Teams-besked; MatchPilot sender sit eget hændelsesformat, ikke tjenestens beskedformat.
{
"id": "event-id",
"event": "consultant.created",
"created_at": "2026-11-20T22:00:00Z",
"data": {
"consultant_id": "consultant-id",
"name": "Anna Eksempel"
}
}Headers: X-MatchPilot-Timestamp, X-MatchPilot-Signature: sha256=… og X-MatchPilot-Event-Id. Et 2xx-svar accepterer leveringen. Fejl får ventetider på 1, 5 og 30 minutter, derefter 2 og 6 timer, højst seks forsøg. Al levering, også Send test og Behandl ventende, er slukket indtil publicering og frigivelse. Derefter kan en Nordic Tender-administrator slå kontakten Aktivér levering til under Administration → Integrationer. Husets modtager skal også være aktiv. Testhændelser indeholder ingen konsulentdata.
Kontrollér signaturen
import { createHmac, timingSafeEqual } from 'node:crypto';
// rawBody er den uændrede request-body, før JSON.parse.
const timestamp = request.headers.get('X-MatchPilot-Timestamp') || '';
const signature = request.headers.get('X-MatchPilot-Signature') || '';
const expected = 'sha256=' + createHmac('sha256', process.env.MATCHPILOT_WEBHOOK_SECRET)
.update(timestamp + '.' + rawBody).digest('hex');
const received = Buffer.from(signature);
const wanted = Buffer.from(expected);
const fresh = /^\d+$/.test(timestamp) && Math.abs(Date.now()/1000 - Number(timestamp)) <= 300;
if (!fresh || received.length !== wanted.length || !timingSafeEqual(received, wanted)) {
return new Response('Ugyldig signatur', { status: 401 });
}
const event = JSON.parse(rawBody);
// Gem event.id med en unik begrænsning: samme event kan blive leveret igen.
return new Response('ok', { status: 200 });Kontrollér signaturen på den rå body før JSON.parse. Afvis gamle tidsstempler, og gem event-id'er for at håndtere gentagelser uden dobbelte ændringer. Hemmeligheden tilhører den konkrete modtager, ikke din API-nøgle.
Claude og ChatGPT
MCP bruger brugerens login og tilladelser, ikke husets API-nøgle. Eksterne huskonti får egne konsulenter og offentlige åbne opgaver. Se MCP-vejledningen. Serveradressen er https://matchpilot.dk/mcp.