Snakker med systemene dere har
API-først. Alt grensesnittet kan, kan andre systemer også, med samme roller og samme tilgang per mappe.
REST-API med OpenAPI
Alt grensesnittet kan, kan API-et. Kundens eget system sender en PDF med API-nøkkel, får en jobb-id, følger jobben eller blir varslet, og henter tekst, JSON med posisjon per blokk, søkbar PDF eller hele dokumentmappen som ZIP.
- Engelske stier, norsk grensesnitt. Spesifikasjonen ligger på tjenesten selv:
/api/openapi.json. - Duplikater avvises på sjekksum, ukjente filtyper avvises med tydelig svar.
- Søk, spør, uttrekk, oppbevaring, brukere og revisjonslogg har egne endepunkter.
Webhook, overvåket mappe og kommandolinje
- Webhook
- Tjenesten kaller en adresse dere velger når en jobb er ferdig, signert med HMAC i headeren
X-Kodetank-Signature. Tre forsøk. - Overvåket mappe
- Skanneren lagrer i
inn/på serverdisken. Ferdige filer flyttes tilbehandlet/, feil tilfeilet/med forklaring. - Kommandolinje
- Samme binær er en tynn klient:
kodetank-lokal konverter faktura.pdf --vent,status,jobberogbackup naa, med--jsonfor skript. - Eksport til andre systemer
- Søkbar PDF til regnskapssystemet, CSV fra uttrekk til import, HTML for visning. Kunden velger selv om noe skal til sky.
MCP-server: la Claude Desktop søke i arkivet
Med modulen MCP-server kan KI-assistenter på deres eget nett søke i, lese fra og spørre arkivet gjennom Model Context Protocol. Nøkkelen har rolle og kan avgrenses til mapper, og alt logges i revisjonsloggen.
- Fire verktøy: liste mapper, søke, hente dokument, spørre. Ingen skriveverktøy; assistenten kan aldri endre eller slette noe.
- Claude Desktop, Cursor, VS Code og egne agenter kobler til samme adresse med samme header.
- Dokumentene sendes ikke til noen sky. Det er klienten på deres maskin som spør tjenesten på deres maskin.
Spørsmål og svar
Kan saksbehandlingssystemet vårt sende dokumenter automatisk?
Ja. Send filen til API-et med en nøkkel, få jobb-id, og bli varslet på webhook når resultatet er klart. Eller la systemet skrive til den overvåkede mappen.
Får vi teksten ut igjen uten tjenesten?
Ja. Hvert dokument er én mappe på disken med original, tekst i Markdown, bilder, metadata som JSON og alle versjoner. Den kan kopieres ut og leses uten tjenesten.