Offentligt API
Et REST API. JMAP. Signerede webhooks. Revisionsloggen.
Verkio er bygget API-first — de samme endpoints, som webappen bruger, er åbne for dig. REST med en OpenAPI 3.1-spec til codegen. Signerede webhooks til de begivenheder, du holder af. JMAP til direkte adgang til mailprotokollen. Revisionsloggen, der kan streames til dit SIEM.
REST
REST med en OpenAPI 3.1-spec.
Hvert endpoint dokumenteret i en enkelt OpenAPI 3.1-fil. Peg dit codegen-værktøj (openapi-generator, oapi-codegen, OpenAPI TS) på /api/v1/openapi.json og få en typet klient i dit foretrukne sprog — eller browse den interaktive reference på /developers.
- OpenAPI 3.1-spec på /api/v1/openapi.json — klar til codegen.
- Interaktiv reference på /developers (Swagger UI).
- Bearer-token-autentificering (RFC 6750). Nøgler hashes med Argon2id i hvile.
- Per-nøgle-ratelimits med X-RateLimit-*-headere. 429'ere med Retry-After.
- Idempotency-Key-understøttelse på muterende endpoints — sikkert at gentage på ustabile netværk.
Signerede webhooks
HMAC-signeret levering med en dead-letter-kø.
Abonnér på de begivenheder, du holder af — ny post, revisionslogsposter, kontoændringer. Hver payload er HMAC-SHA256-signeret, så du kan verificere, at den kom fra Verkio. Fejlede leveringer prøves igen med eksponentiel backoff; vedvarende fejl ender i en dead-letter-kø, du kan inspicere og afspille igen.
- HMAC-SHA256-signatur pr. payload (X-Verkio-Signature-header).
- Eksponentielle backoff-genforsøg ved 5xx- og forbindelsesfejl.
- Dead-letter-kø i dashboardet — inspicér, afspil igen, afvis.
- Hvert leveringsforsøg logges i revisionsloggen.
JMAP-passthrough
Tal den moderne mailprotokol direkte.
Verkios underliggende mailserver taler JMAP (RFC 8620 / 8621) — den moderne, JSON-baserede efterfølger til IMAP. Det offentlige API tilbyder en JMAP-passthrough, så klientbiblioteker kan tale direkte med dine postkasser uden at skulle genimplementere hvert endpoint på serversiden.
- JMAP Core (RFC 8620) og JMAP Mail (RFC 8621) over /api/v1/jmap.
- Brug ethvert JMAP-kompatibelt klientbibliotek — jmap-client (JS), python-jmap, andre.
- Push-notifikationer via JMAP EventSource — ingen polling.
- IMAP og SMTP er også tilgængelige for klienter, der har brug for dem.
Revisionslog-API
Hver admin-handling, streambar.
Den samme revisionslog, som du læser i dashboardet, er tilgængelig som et API — pagineret, filtrerbart, med før/efter-værdier på hver ændring. Stream begivenheder til Splunk, Datadog eller et hvilket som helst SIEM, der accepterer en webhook eller poller et pagineret endpoint. Eksportér til CSV eller JSONL til retsmedicinsk analyse.
- Pagineret og filtrerbart: efter bruger, begivenhedstype, datointerval.
- Før/efter-værdier på hver mutation — fuldt retsmedicinsk spor.
- Stream til dit SIEM via webhook eller pull-endpoint.
- Eksportér til CSV eller JSONL til offlineanalyse. Syv års opbevaring som standard.
Produktionsklar
Bygget til de langvarige integrationer, du faktisk vil skrive.
Scoped API-nøgler med rotation. Per-nøgle-ratelimits. Idempotens ved skrivninger. Versionerede URL'er, så en udfasning ikke overrasker dig en stille søndag. De kedelige garantier, der gør en integration værd at skrive.
- Scoped API-nøgler — read-only, scoped til en postkasse, scoped til en organisation.
- Nøglerotation i dashboardet — tilbagekald og udsted nye uden nedetid.
- URL-versioneret (/api/v1/…) med deprecation-headere måneder i forvejen.
- OpenAPI-changelog offentliggjort; brydende ændringer kun ved major-versionsbump.
Åbne standarder
RFC'er og OpenAPI. Intet proprietært.
Hver protokol, det offentlige API taler, er offentligt dokumenteret. Tag dit codegen-værktøj med. Tag dit eksisterende klientbibliotek med. Intet her er opfundet til en vendor-pitch.
- 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
Lancering i juli 2026
Tilmeld ventelisten
Vi hører fra os, når Verkio åbner.