API и интеграция

JSON API с префиксом /api/v1/…. Актуальные маршруты — в OpenAPI на вашем стенде. В примерах замените YOUR_HOST на хост.

Документация

Интерактив: /docs (если включено).
Схема: GET /api/v1/openapi.json.
Статус: GET /health, GET /readiness, GET /api/v1/status.

Соглашения

HTTPS в проде.
Content-Type: application/json (кроме загрузки файлов по спору).
После POST /api/v1/auth/login — cookie и/или Authorization: Bearer ….
Обновление: POST /api/v1/auth/refresh.
Для чувствительных операций может использоваться Idempotency-Key — см. OpenAPI.

Основные группы

Auth и сессии: register, login, refresh, logout, MFA.
Профиль и кошелёк: /api/v1/me, /api/v1/wallet/balances, /api/v1/wallet/activity.
Эскроу: создать, список, fund, release, dispute.
Helpdesk: тикеты.
Полный перечень — в OpenAPI.

Поддержка интеграции

Вопросы по доступу и сценариям: справка или support@evopay.biz. Авторизованные клиенты могут создавать тикеты через POST /api/v1/helpdesk/tickets.

Примеры

json · тело запроса

{
  "email": "user@example.com",
  "password": "YourStrongPassw0rd!",
  "display_name": "Demo User"
}

bash · регистрация

curl -sS -X POST "https://YOUR_HOST/api/v1/auth/register" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "password": "YourStrongPassw0rd!",
    "display_name": "Demo User"
  }'

bash · вход

curl -sS -X POST "https://YOUR_HOST/api/v1/auth/login" \
  -H "Content-Type: application/json" \
  -c cookies.txt \
  -d '{
    "email": "user@example.com",
    "password": "YourStrongPassw0rd!"
  }'

bash · профиль и кошелёк

curl -sS "https://YOUR_HOST/api/v1/me" -b cookies.txt

curl -sS "https://YOUR_HOST/api/v1/wallet/balances" -b cookies.txt

curl -sS "https://YOUR_HOST/api/v1/wallet/activity?limit=20" -b cookies.txt

bash · создать эскроу

curl -sS -X POST "https://YOUR_HOST/api/v1/escrow" \
  -H "Content-Type: application/json" \
  -b cookies.txt \
  -d '{
    "title": "Поставка оборудования",
    "description": "Серверное оборудование по спецификации",
    "amount": "8000.00",
    "currency": "USD"
  }'

Далее подставьте ESCROW_ID:

bash · жизненный цикл эскроу

curl -sS "https://YOUR_HOST/api/v1/escrow/contracts/ESCROW_ID" -b cookies.txt

curl -sS -X POST "https://YOUR_HOST/api/v1/escrow/ESCROW_ID/fund" \
  -H "Content-Type: application/json" -b cookies.txt -d '{}'

curl -sS -X POST "https://YOUR_HOST/api/v1/escrow/ESCROW_ID/release" \
  -H "Content-Type: application/json" -b cookies.txt -d '{}'

bash · статус

curl -sS "https://YOUR_HOST/api/v1/status"
curl -sS "https://YOUR_HOST/readiness"