API og webhooks

Hvor du finner det

Hvis dokumentene på kontoret ditt starter et annet sted enn i DocuTract, kan det systemet snakke med oss direkte. Åpne menyen med adressen din øverst til høyre og velg Integrasjoner: der utstedes et token som systemet ditt kaller oss med, og der legger du til adressen vi varsler om ferdige dokumenter på.

Skjermen begynner med ferdige CRM-koblinger (CRM-integrasjoner); tokenene og webhookene som beskrives her, står under dem, i delen API og webhooks.

Tokenet

Trykk Opprett et token, gi det et navn du kjenner igjen senere (så du vet hvilket system som bruker det), og kryss av for hva det har lov til: lese maler, opprette dokumenter, arbeide med saker.

Selve tokenet vises én gang, rett etter at det er opprettet: vi lagrer bare en hash av det, så å vise det en gang til er noe ikke engang vi kan. Kopier det rett inn i innstillingene til systemet ditt.

Listen viser de første tegnene i hvert token, hva det har lov til, og når det sist ble brukt. Tilbakekall slår av et token umiddelbart; registreringen av det blir stående, så det er synlig at det fantes og når det sluttet å fungere.

Hva API-et kan gjøre

Systemet ditt kan:

• åpne en sak og laste opp skanninger i den;
• opprette et dokument fra en mal med verdiene allerede utfylt;
• spørre hvilket stadium et dokument har nådd;
• hente hver verdi sammen med skanningen den ble lest fra;
• få en kortlivet lenke til den ferdige filen.

Den fullstendige beskrivelsen av hver adresse og hvert felt genereres fra selve koden og publiseres åpent: API-beskrivelsen.

Webhooks

I stedet for å spørre oss om et dokument er klart, gir du oss en adresse, så skriver vi til deg. Legg den til under Webhooks og kryss av for hendelsene: dokument klart, dokument mislyktes, sak klar, et avvik funnet, en kunde sendte en fil.

Hver forespørsel signeres med headeren X-DocuTract-Signature, og hemmeligheten som bekrefter signaturen, vises én gang, akkurat som tokenet. Systemet ditt må sjekke signaturen og svare med en 2xx-kode. Hvis det svarer noe annet, eller ikke svarer i det hele tatt, prøver vi igjen: etter ett minutt, etter fem, etter en halvtime, etter to timer og etter ti, og så slutter vi.

Når noe ikke kom frem

Knappen Leveranser viser loggen: hvilken hendelse vi sendte, når, hvor mange ganger, hvilken svarkode som kom tilbake, og begynnelsen av svarteksten. Det er svaret på «systemet vårt mottok ingenting»: det står svart på hvitt at det svarte 500 fire ganger klokken 14.12.

Send test sender en ping til adressen med en gang, uten å vente på en ekte hendelse, så en mottaker kan settes opp før noe arbeid går gjennom den. Prøv igjen, ved siden av en mislykket levering, gjør ett forsøk til umiddelbart.

Zapier, Make og n8n

No-code-plattformer (tjenester der man bygger en integrasjon uten å programmere) abonnerer selv på hendelsene våre via REST hooks-delen av API-et, så ingen trenger å kopiere adressene deres inn i DocuTract. Gi plattformen et token med rettighetene webhooks:read og webhooks:write, pluss de rettighetene handlingene dens trenger (for eksempel templates:read og documents:write).

• POST /api/v1/hooks med {"event": "document.ready", "target_url": "https://…"} abonnerer en adresse på én hendelse. Svaret inneholder abonnementets id og, én gang, dets secret for signaturen.
• GET /api/v1/hooks viser abonnementene som er laget slik; DELETE /api/v1/hooks/{id} fjerner ett.
• GET /api/v1/hooks/events viser hendelsene: document.ready, document.failed, case.ready, finding.raised, intake.uploaded.
• GET /api/v1/hooks/samples/{event} returnerer et eksempel på innholdet, som plattformen viser i sin «testutløser» før noen ekte hendelse har skjedd.

Et abonnement er en vanlig webhook-adresse: signert, forsøkt på nytt og logget på samme måte, og synlig i listen under Webhooks. Det stopper når tokenet som laget det, trekkes tilbake eller utløper, eller når plattformen svarer på en leveranse med 410 Gone.

Slik ser document.ready ut:

{
  "document_id": "00000000-0000-4000-8000-000000000001",
  "reference": "DOC-26-0001",
  "template_id": "00000000-0000-4000-8000-000000000002",
  "template_version": 1,
  "event": "document.ready",
  "occurred_at": "2026-01-15T10:30:00+00:00"
}

og slik case.ready:

{
  "case_id": "00000000-0000-4000-8000-000000000003",
  "title": "Sample case",
  "documents": [
    { "id": "00000000-0000-4000-8000-000000000001", "reference": "DOC-26-0001" }
  ],
  "event": "case.ready",
  "occurred_at": "2026-01-15T10:30:00+00:00"
}

Feltene i en mal

GET /api/v1/templates/{id}/fields (rettighet templates:read) viser hva en mal trenger: hvert felts key (som values i POST /api/v1/documents angis etter), feltets label, hvor det fylles ut fra, og fillable, som er false for et felt DocuTract fyller ut selv, for eksempel en dato. Et skjema i Zapier eller Make bygges fra denne listen og passer derfor alltid til malen slik den er nå.

Oppslag

Noen kall finnes slik at et system, eller en no-code-plattform, finner det det trenger uten å gjette:

• GET /api/v1/me (ingen tillatelse) returnerer arbeidsområdet tokenet hører til, abonnementet og tokenets eget navn og tillatelser. Det er den enkleste måten å sjekke at et token virker på.
• GET /api/v1/documents (tillatelse documents:read) viser de nyeste dokumentene først. Avgrens med reference (den nøyaktige DOC-…-referansen), status eller template_id; limit går opp til 100, standard er 25.
• GET /api/v1/cases (tillatelse cases:read) viser de nyeste sakene, eventuelt bare de med én status, med samme limit. Hver sak har nå også sin created_at.
• GET /api/v1/case-types (tillatelse cases:read) viser sakstypene en sak kan opprettes fra.
• GET /api/v1/templates?name=… beholder bare malene der navnet inneholder teksten, uavhengig av store og små bokstaver.

Det er med vilje ingen sideinndeling: listene er for å finne det nyeste, ikke for å eksportere et helt arbeidsområde.

Hvilken plan

API og webhooks er en del av Team-planen. I alle andre planer er tokenene og adressene du allerede har opprettet, fortsatt synlige og kan tilbakekalles, men nye utstedes ikke, og kall som gjøres med et token, blir ikke lenger besvart. Sammenlign planer på prissiden.