Sladd API

Norsk PII-sladding som komponent i ditt fagsystem. PDF eller tekst inn; funn-liste eller sladdet, verifisert dokument ut. Dere har dokumentflyten; vi leverer sladdingen. Første sladdede dokument på under 5 minutter.

Endepunkter

Endepunkt	Hva
POST /api/v1/redact	Hovedproduktet. PDF/tekst inn → sladdet PDF (rasterisert, tekst fjernet permanent) + rapport med verification-blokk. Én request, ferdig.
POST /api/v1/detect	Funn-liste som JSON: type, tegn-posisjon, confidence, PDF-koordinater. For dere som vil sladde selv.
GET /api/v1/health	Status og versjon. Uautentisert.

Maskinlesbar spesifikasjon: openapi.yaml

Kom i gang

Alle kall autentiseres med en API-nøkkel som Bearer-token. Nøkler utstedes manuelt i v1. Send en e-post til post@sladd.no, så har du nøkkel samme dag.

curl -X POST https://sladd.no/api/v1/redact \
  -H "Authorization: Bearer sk_sladd_..." \
  -F "file=@vedtak.pdf" \
  -o "vedtak [sladd].pdf"

Svaret er den sladdede PDF-en. Rapportsammendraget (antall funn, verifikasjonsstatus) følger i X-Sladd-Report-headeren. Grenser i v1: 20 MB, 80 sider, 60 requests/minutt per nøkkel.

Verifisert, ikke bare sladdet

Etter sladding re-skanner API-et output-dokumentet og bekrefter at alt det detekterte faktisk er borte. En redaksjon som lekker returneres aldri; kallet feiler i stedet. Rapporten inneholder aldri originalteksten, kun typer og posisjoner. Vi lover presist det vi kan holde: verifikasjonen garanterer at alle detekterte funn er fjernet, ikke at dokumentet er fritt for all PII.

Flyktighetsløftet

Web-appen vår behandler alt lokalt i nettleseren. API-et behandler dokumentet på vår server, men kompenserer med et løfte vi mener bokstavelig:

• Behandles kun i minnet og forkastes når requesten er ferdig
• Skrives aldri til disk: ingen mellomlagring, kø eller backup
• Logges aldri: kun metadata (endepunkt, mode, sideantall), aldri innhold eller filnavn

Trenger dere full kontroll? Samme motor finnes som self-hosted Docker-image og CLI. Dokumentet forlater aldri deres nettverk.

For AI-agenter (MCP)

Sladd er tilgjengelig som MCP-server (Model Context Protocol), slik at Claude og andre MCP-kompatible agenter kan sladde norske dokumenter før innholdet går videre i agent-flyten. To verktøy: detect_pii og redact_document.

Lokal installasjon (Claude Desktop, claude_desktop_config.json):

{
  "mcpServers": {
    "sladd": {
      "command": "npx",
      "args": ["-y", "@sladd-no/mcp"],
      "env": { "SLADD_API_KEY": "sk_sladd_..." }
    }
  }
}

Remote (klienter med header-støtte: Claude Code, Cursor, VS Code):

URL:    https://sladd.no/mcp
Header: Authorization: Bearer sk_sladd_...

Maskinlesbar peker: /.well-known/mcp.json

Moduser

mode=fast (default): regex med MOD10/MOD11-validering + norske navne- og ordlister. Deterministisk og raskt. mode=deep legger til en norsk NER-modell for høyere recall på navn og fritekst. Den rulles ut nå; inntil aktiv svarer den mode_unavailable.

Få API-nøkkel Les OpenAPI-specen