Offentlig API
Et REST API. JMAP. Signerte webhooks. Revisjonsloggen.
Verkio er bygd API-first — de samme endepunktene webappen bruker er åpne for deg. REST med en OpenAPI 3.1-spesifikasjon for codegen. Signerte webhooks for hendelsene du bryr deg om. JMAP for direkte tilgang til e-postprotokollen. Revisjonsloggen streambar til SIEM-en din.
REST
REST med en OpenAPI 3.1-spesifikasjon.
Hvert endepunkt dokumentert i én OpenAPI 3.1-fil. Pek codegen-verktøyet ditt (openapi-generator, oapi-codegen, OpenAPI TS) mot /api/v1/openapi.json og få en typet klient på det språket du foretrekker — eller bla i den interaktive referansen på /developers.
- OpenAPI 3.1-spesifikasjon på /api/v1/openapi.json — klar for codegen.
- Interaktiv referanse på /developers (Swagger UI).
- Bearer-token-autentisering (RFC 6750). Nøkler hashes med Argon2id i hvile.
- Per-nøkkel-ratelimits med X-RateLimit-*-headere. 429-er med Retry-After.
- Idempotency-Key-støtte på muterende endepunkter — trygt å prøve igjen på ustabile nett.
Signerte webhooks
HMAC-signert levering med dead-letter-kø.
Abonner på hendelsene du bryr deg om — ny post, revisjonsloggoppføringer, kontoendringer. Hver payload er HMAC-SHA256-signert så du kan verifisere at den kom fra Verkio. Mislykkede leveringer prøves igjen med eksponentiell backoff; vedvarende feil havner i en dead-letter-kø du kan inspisere og spille av på nytt.
- HMAC-SHA256-signatur per payload (X-Verkio-Signature-header).
- Eksponentielle backoff-forsøk på 5xx og tilkoblingsfeil.
- Dead-letter-kø i dashbordet — inspiser, spill av på nytt, avvis.
- Hvert leveringsforsøk logges i revisjonsloggen.
JMAP-passthrough
Snakk den moderne e-postprotokollen direkte.
Verkios underliggende e-postserver snakker JMAP (RFC 8620 / 8621) — den moderne, JSON-baserte etterfølgeren til IMAP. Det offentlige API-et tilbyr en JMAP-passthrough så klientbiblioteker kan snakke direkte med postkassene dine uten å reimplementere hvert endepunkt på tjenersiden.
- JMAP Core (RFC 8620) og JMAP Mail (RFC 8621) over /api/v1/jmap.
- Bruk hvilket som helst JMAP-kompatibelt klientbibliotek — jmap-client (JS), python-jmap, andre.
- Push-varsler via JMAP EventSource — ingen polling.
- IMAP og SMTP er også tilgjengelige for klienter som trenger dem.
Revisjonslogg-API
Hver admin-handling, streambar.
Den samme revisjonsloggen du leser i dashbordet er tilgjengelig som et API — paginert, filtrerbart, med før/etter-verdier på hver endring. Stream hendelser til Splunk, Datadog eller hvilket som helst SIEM som tar imot en webhook eller poller et paginert endepunkt. Eksporter til CSV eller JSONL for kriminalteknisk analyse.
- Paginert og filtrerbart: etter bruker, etter hendelsestype, etter datointervall.
- Før/etter-verdier på hver mutasjon — fullt kriminalteknisk spor.
- Stream til SIEM-en din via webhook eller pull-endepunkt.
- Eksporter til CSV eller JSONL for offline-analyse. Sju års oppbevaring som standard.
Produksjonsklar
Bygd for de langtidsintegrasjonene du faktisk har lyst til å skrive.
Scopede API-nøkler med rotasjon. Per-nøkkel-ratelimits. Idempotens ved skriving. Versjonerte URL-er så en utfasing ikke overrasker deg en stille søndag. De kjedelige garantiene som gjør en integrasjon verdt å skrive.
- Scopede API-nøkler — read-only, scoped til en postkasse, scoped til en organisasjon.
- Nøkkelrotasjon i dashbordet — tilbakekall og utsted nye uten nedetid.
- URL-versjonert (/api/v1/…) med deprecation-headere måneder i forveien.
- OpenAPI-endringslogg publisert; brytende endringer kun ved major-versjonshopp.
Åpne standarder
RFC-er og OpenAPI. Ingenting proprietært.
Hver protokoll det offentlige API-et snakker er offentlig dokumentert. Ta med codegen-verktøyet ditt. Ta med det eksisterende klientbiblioteket ditt. Ingenting her er funnet opp for en leverandørpitch.
- OpenAPI 3.1
- REST
- JMAP Core (RFC 8620)
- JMAP Mail (RFC 8621)
- Bearer auth (RFC 6750)
- HMAC-SHA256 (RFC 6234)
- Argon2id key hashing
- TLS 1.3
Lanseres i juli 2026
Bli med på ventelisten
Vi hører fra oss når Verkio åpner.