API-referanse

Base: https://api.rempar.org/v1. JSON overalt. Vellykkede svar pakkes inn i {"data": ...}, feil i {"error": {"code": "...", "message": "..."}}. Autentisering med et Bearer-token som er unikt for hver enhet.

API-et er nullkunnskap: det mottar aldri passord eller innhold i klartekst. Tredjepartsklienter er velkomne så lenge de følger protokoll v1.

Helse

GET /v1/health
→ { "data": { "status": "ok", "release": "1.1.0" } }

Autentisering

Metode Rute Body Svar
POST /auth/prelogin {email} {kdf, kdf_salt}. Deterministisk falskt salt hvis e-postadressen er ukjent.
POST /auth/register {email, auth_key, kdf, kdf_salt, device} 201 {status: "verification_sent"}. En sekssifret kode sendes på e-post.
POST /auth/verify-email {email, code} {}
POST /auth/login {email, auth_key, device, totp?, code?} {tokens, device_id, vault_key_sealed?}. Feilen totp_required (403) hvis 2FA er slått på og koden mangler. Deretter email_code_required (403): en sekssifret kode sendes på e-post og må sendes tilbake i code for å få tokenene (10 min, 5 forsøk).
POST /auth/refresh {refresh_token} {access_token, refresh_token, ...}. Rotasjon; gjenbruk tilbakekaller enheten.
POST /auth/logout Tilbakekaller den gjeldende enheten.
POST /auth/recover {email, recovery_auth, totp?} Bevis fra gjenopprettingssettet: returnerer {vault_key_recovery, recovery_token} (15 min). totp_required hvis 2FA er slått på.
POST /auth/recover/complete {email, recovery_token, auth_key, kdf, kdf_salt, vault_key_sealed, device} Nytt hovedpassord: erstatter autentiseringsnøkkelen og den nyforseglede hvelvnøkkelen, tilbakekaller alle andre enheter og logger inn denne ({tokens, device_id, vault_key_sealed}).

device: {name, platform, client_id}, der client_id er en UUID som klienten velger, og som er stabil for denne enheten.

kdf: {"algo": "argon2id", "m": 65536, "t": 3, "p": 4}. Klientene avviser parametere som er svakere enn m=19456, t=2, p=1.

Konto

Metode Rute Beskrivelse
GET /account E-postadresse, 2FA-status, hvelvrevisjon, abonnement {plan, active, until}.
GET /account/subscription Bare abonnementet.
POST /account/password Erstatter auth_key etter at hovedpassordet er endret. Klienten publiserer først den nyforseglede hvelvnøkkelen.
GET /account/devices Aktive enheter.
DELETE /account/devices/{id} Tilbakekaller en enhet.
POST /account/totp/setup Genererer en hemmelighet og returnerer {secret, otpauth_url}.
POST /account/totp/enable {code}: slår på 2FA.
POST /account/totp/disable {code}: slår av 2FA.

Hvelv

Metode Rute Beskrivelse
PUT /vault/key {vault_key_sealed, vault_key_recovery?}: bare forseglede blober, erstattes atomisk. Alltid tillatt (gjenoppretting).
GET /vault/items?since=<revision>&limit=500 {items: [{id, revision, deleted, blob, updated_at}], revision}. Krever et aktivt abonnement.
POST /vault/items {base_revision, items: [{id, blob|null}]} → {revision, conflicts: []}. blob: null sletter (gravstein). Hvis base_revision er utdatert, returnerer serveren newer_items i stedet for å skrive. Maks 500 elementer per sending. Krever et aktivt abonnement.

Abonnement

Cloud-abonnementet starter med en gratis prøveperiode på 7 dager (trial), startet via Stripe, App Store eller Google Play (se GET /v1/account/subscription). Uten aktivt abonnement svarer synkroniseringsrutene 402 subscription_required; den forseglede hvelvnøkkelen kan fortsatt leses, slik at gjenoppretting er mulig. Klienten viser «Venter» og fortsetter lokalt.

Feilkoder

Kode HTTP Betydning
invalid_credentials 401 Feil e-postadresse, nøkkel eller kode.
unauthenticated 401 Token mangler eller er utløpt, eller enheten er tilbakekalt.
email_unverified 403 E-postkoden er ikke skrevet inn.
totp_required 403 Oppgi totp.
subscription_required 402 Cloud-abonnementet er utløpt.
email_taken 409 Det finnes allerede en bekreftet konto med denne e-postadressen.
stale_revision 409 Hent først de returnerte newer_items.
token_reused 401 Gjenbruk oppdaget, enheten er tilbakekalt.

Hastighetsbegrensninger

Forhåndspålogging 30/min, registrering og bekreftelse 10/min, pålogging 15/min, fornyelse 30/min, autentiserte ruter 240/min per enhet.

Eksempel

curl -s https://api.rempar.org/v1/auth/prelogin \
  -H 'Content-Type: application/json' \
  -d '{"email":"vous@example.org"}'

Har du et spørsmål som ikke besvares her? support@rempar.org