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