Referința API

Bază: https://api.rempar.org/v1. JSON peste tot. Răspunsurile reușite sunt încapsulate în {"data": ...}, erorile în {"error": {"code": "...", "message": "..."}}. Autentificare prin token Bearer propriu fiecărui dispozitiv.

API-ul este zero-knowledge: nu primește niciodată parole sau conținut în clar. Clienții terți sunt bineveniți atât timp cât respectă protocolul v1.

Stare

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

Autentificare

Metodă Rută Corp Răspuns
POST /auth/prelogin {email} {kdf, kdf_salt}. Sare fictivă deterministă dacă adresa de e-mail este necunoscută.
POST /auth/register {email, auth_key, kdf, kdf_salt, device} 201 {status: "verification_sent"}. Se trimite prin e-mail un cod de șase cifre.
POST /auth/verify-email {email, code} {}
POST /auth/login {email, auth_key, device, totp?, code?} {tokens, device_id, vault_key_sealed?}. Eroare totp_required (403) dacă 2FA este activă și codul lipsește. Apoi email_code_required (403): se trimite prin e-mail un cod de șase cifre, care trebuie retrimis în code pentru a obține tokenurile (10 min, 5 încercări).
POST /auth/refresh {refresh_token} {access_token, refresh_token, ...}. Rotație; o reutilizare revocă dispozitivul.
POST /auth/logout Revocă dispozitivul curent.
POST /auth/recover {email, recovery_auth, totp?} Dovada kitului de recuperare: returnează {vault_key_recovery, recovery_token} (15 min). totp_required dacă 2FA este activă.
POST /auth/recover/complete {email, recovery_token, auth_key, kdf, kdf_salt, vault_key_sealed, device} Parolă principală nouă: înlocuiește cheia de autentificare și cheia seifului resigilată, revocă toate celelalte dispozitive, conectează dispozitivul curent ({tokens, device_id, vault_key_sealed}).

device: {name, platform, client_id}, unde client_id este un UUID ales de client, stabil pentru acest dispozitiv.

kdf: {"algo": "argon2id", "m": 65536, "t": 3, "p": 4}. Clienții refuză parametri mai slabi decât m=19456, t=2, p=1.

Cont

Metodă Rută Descriere
GET /account E-mail, stare 2FA, revizia seifului, abonament {plan, active, until}.
GET /account/subscription Doar abonamentul.
POST /account/password Înlocuiește auth_key după o schimbare a parolei principale. Clientul republică mai întâi cheia seifului resigilată.
GET /account/devices Dispozitive active.
DELETE /account/devices/{id} Revocă un dispozitiv.
POST /account/totp/setup Generează un secret și returnează {secret, otpauth_url}.
POST /account/totp/enable {code}: activează 2FA.
POST /account/totp/disable {code}: dezactivează 2FA.

Seif

Metodă Rută Descriere
PUT /vault/key {vault_key_sealed, vault_key_recovery?}: doar blobs sigilate, înlocuite atomic. Permis întotdeauna (restaurare).
GET /vault/items?since=<revision>&limit=500 {items: [{id, revision, deleted, blob, updated_at}], revision}. Necesită un abonament activ.
POST /vault/items {base_revision, items: [{id, blob|null}]} → {revision, conflicts: []}. blob: null șterge (tombstone). Dacă base_revision este depășită, serverul returnează newer_items în loc să scrie. Maximum 500 de elemente per trimitere. Necesită un abonament activ.

Abonament

Abonamentul Cloud începe cu o perioadă de probă gratuită de 7 zile (trial), pornită prin Stripe, App Store sau Google Play (vezi GET /v1/account/subscription). Fără un abonament activ, rutele de sincronizare răspund 402 subscription_required; cheia seifului sigilată rămâne lizibilă pentru a permite o restaurare. Clientul afișează „În așteptare” și continuă local.

Coduri de eroare

Cod HTTP Semnificație
invalid_credentials 401 E-mail, cheie sau cod incorect.
unauthenticated 401 Token absent, expirat sau dispozitiv revocat.
email_unverified 403 Codul din e-mail nu a fost introdus.
totp_required 403 Furnizați totp.
subscription_required 402 Abonament Cloud expirat.
email_taken 409 Există deja un cont verificat cu această adresă de e-mail.
stale_revision 409 Preluați mai întâi newer_items returnate.
token_reused 401 Reutilizare detectată, dispozitiv revocat.

Limite de rată

Pre-conectare 30/min, înregistrare și verificare 10/min, conectare 15/min, reîmprospătare 30/min, rute autentificate 240/min per dispozitiv.

Exemplu

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

Aveți o întrebare fără răspuns aici? support@rempar.org