REST API

Authorization: Bearer <token>

// Request
{
  "email": "user@example.com",
  "password": "securepassword123"
}

// Response 201
{
  "token": "eyJhbGci...",
  "userId": "uuid",
  "workspaceId": "uuid"
}

// Request
{ "email": "user@example.com", "password": "securepassword123" }

// Response 200
{ "token": "eyJhbGci...", "userId": "uuid", "workspaceId": "uuid" }

// POST /api-keys request
{
  "name": "prod-server",
  "scopes": ["backups.upload", "backups.read"],
  "databaseId": "uuid",      // опционально: ключ работает только с этой базой, для других — 403
  "expiresInDays": 90         // опционально: 1–3650
}

// Response 201
{
  "data": {
    "id": "uuid",
    "name": "production-key",
    "keyPrefix": "sqv_pk_47a5",
    "databaseId": "uuid",
    "expiresAt": "2027-01-04T00:00:00.000Z",
    "plainKey": "sqv_pk_47a5383b4f7e057975cafb...",  // только при создании!
    "createdAt": "2026-01-01T00:00:00.000Z"
  }
}

// POST /databases
{
  "projectId": "uuid",
  "name": "production-db",
  "engineType": "sqlite"   // sqlite | duckdb | postgresql_dump | mysql_dump | mssql_backup | onec_dt | generic_file
}

// Response 201
{
  "data": {
    "id": "uuid",
    "name": "production-db",
    "engineType": "sqlite",
    "status": "active",
    "createdAt": "2026-01-01T00:00:00Z"
  }
}

// POST /backups/upload — файл не изменился
{
  "deduplicated": true,
  "snapshot": { "id": "uuid", "versionNumber": 11, "label": null, "pinned": false, ... }
}

// PATCH /backups/snapshots/:snapshotId
{ "label": "до миграции 0042", "pinned": true }

// Response 200 — обновлённая версия
{ "id": "uuid", "versionNumber": 12, "label": "до миграции 0042", "pinned": true, ... }

// GET /billing/usage
{
  "planId": "start",
  "planName": "Старт",
  "storedBytes": 734003200,
  "storageLimitBytes": 10737418240,   // null — без лимита
  "databases": 3,
  "databasesLimit": 5,                // null — без лимита
  "maxVersionsPerDatabase": 30,
  "gracePeriodEndsAt": null,          // ISO-дата, если идёт льготный период после окончания подписки
  "subscriptionEndsAt": "2026-11-06T00:00:00.000Z"
}

// POST /backups/:id/restore
{ "targetType": "download" }

// Response 200
{
  "data": {
    "jobId": "uuid",
    "status": "completed",
    "downloadUrl": "https://...",
    "expiresInSeconds": 900,
    "filename": "data.db",
    "version": 3
  }
}

// Формат ошибки
{
  "error": {
    "code": "QUOTA_EXCEEDED",
    "message": "Превышен лимит хранилища...",
    "requestId": "uuid"
  }
}