Документация | Справочник API

Обзор

Партнёрская программа позволяет приглашать новых пользователей в систему и отслеживать статус приглашений.

Приглашения по email

Отправляйте красивые письма-приглашения на любом языке.

Отслеживание статуса

Следите за статусом каждого приглашения в реальном времени.

Автоматическое подтверждение

Статус автоматически обновляется при регистрации приглашённого.

Система вознаграждений

В разработке: бонусы и скидки за каждого привлечённого пользователя.

Статусы приглашений

Каждое приглашение имеет один из трёх статусов:

Приглашён

Приглашение отправлено, ожидаем регистрации.

Зарегистрирован

Приглашённый зарегистрировался в системе.

Отклонено

Приглашённый отказался от участия.

Как это работает

Простой процесс приглашения партнёров:

1

Создайте приглашение

Укажите имя и email человека, которого хотите пригласить.

2

Письмо отправляется

Система автоматически отправляет красивое письмо-приглашение.

3

Ожидайте регистрацию

Приглашённый получает письмо и может зарегистрироваться.

4

Статус обновляется

При регистрации статус автоматически меняется на "Зарегистрирован".

Что планируется

Мы активно работаем над системой вознаграждений для партнёров:

Бонусы за каждого привлечённого пользователя
Скидки на премиум функции платформы
Эксклюзивный доступ к новым возможностям
Накопительная система вознаграждений

REST API

Доступ к партнёрским приглашениям через REST API (требуется JWT авторизация):

GET    /api/v1/partner-invitations           - Список приглашений
POST   /api/v1/partner-invitations           - Создать приглашение
GET    /api/v1/partner-invitations/{id}      - Детали приглашения
POST   /api/v1/partner-invitations/{id}/resend - Отправить повторно

Пример запроса

POST /api/v1/partner-invitations
Content-Type: application/json
Authorization: Bearer your-token

{
  "name": "John Doe",
  "email": "[email protected]",
  "locale": "uk"
}

Пример ответа

{
  "success": true,
  "message": "Invitation sent successfully",
  "invitation": {
    "id": 1,
    "name": "John Doe",
    "email": "[email protected]",
    "locale": "uk",
    "status": "invited",
    "invited_at": "2026-01-19T12:00:00+00:00"
  },
  "updated": false
}

Swagger / OpenAPI

Полная документация API с интерактивным тестированием доступна в Swagger UI: /api/v1/doc