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