Единый профиль болельщика, ученика школы или участника мероприятия. Профиль хранится в общем ядре, с которым работают все продукты «Виража», поэтому один ID действует одновременно в CRM, ДЮСШ, билетах и лояльности.

Обзор методов

Список пользователей

GET /users

Возвращает пользователей клуба постранично, с фильтрами по дате регистрации и статусу лояльности. Следующую страницу запрашивают с cursor из ответа.

Параметры

curl "https://api.virazh.io/v1/users?limit=20&loyalty_status=gold" \
  -H "Authorization: Bearer sk_test_51H..."

{
  "data": [
    { "id": "usr_8f21c", "name": "Иван Петров", "loyalty_status": "gold" },
    { "id": "usr_71bd0", "name": "Мария Орлова", "loyalty_status": "gold" }
  ],
  "has_more": true,
  "next_cursor": "usr_71bd0"
}

Поля ответа

Получить профиль пользователя

GET /users/{id}

Возвращает карточку пользователя с базовыми полями и ссылками на связанные сущности: программу лояльности, покупки, посещаемость.

Параметры

curl https://api.virazh.io/v1/users/usr_8f21c \
  -H "Authorization: Bearer sk_test_51H..."

{
  "id": "usr_8f21c",
  "name": "Иван Петров",
  "phone": "+7 900 123-45-67",
  "email": "ivan@example.com",
  "created_at": "2026-03-14T09:02:00Z",
  "loyalty": {
    "status": "silver",
    "points": 1240
  }
}

Поля ответа

Создать пользователя

POST /users

Регистрирует нового пользователя. Если пользователь с таким телефоном уже есть, метод вернёт существующую карточку и дубликат не создаст.

Параметры

curl https://api.virazh.io/v1/users \
  -X POST \
  -H "Authorization: Bearer sk_test_51H..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Иван Петров",
    "phone": "+79001234567"
  }'

{
  "id": "usr_8f21c",
  "name": "Иван Петров",
  "phone": "+7 900 123-45-67",
  "created_at": "2026-08-25T11:40:12Z"
}

Поля ответа

Обновить профиль

PATCH /users/{id}

Обновляет профиль частично: в запросе достаточно передать изменившиеся поля. Телефон и email система заново проверяет на уникальность.

Параметры

curl https://api.virazh.io/v1/users/usr_8f21c \
  -X PATCH \
  -H "Authorization: Bearer sk_test_51H..." \
  -H "Content-Type: application/json" \
  -d '{ "email": "ivan.petrov@example.com" }'

{
  "id": "usr_8f21c",
  "email": "ivan.petrov@example.com",
  "updated_at": "2026-08-25T11:44:02Z"
}

Поля ответа

Удалить пользователя

DELETE /users/{id}

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

Параметры

curl https://api.virazh.io/v1/users/usr_8f21c \
  -X DELETE \
  -H "Authorization: Bearer sk_test_51H..."

{
  "id": "usr_8f21c",
  "status": "deleted",
  "deleted_at": "2026-08-25T12:10:00Z"
}

Поля ответа

Лента активности

GET /users/{id}/activity

Журнал действий пользователя в хронологическом порядке: покупки, посещения тренировок, начисления баллов, участие в рассылках. Подходит для карточки клиента в вашей CRM.

Параметры

curl "https://api.virazh.io/v1/users/usr_8f21c/activity?limit=10" \
  -H "Authorization: Bearer sk_test_51H..."

{
  "user_id": "usr_8f21c",
  "data": [
    { "type": "ticket_purchase", "at": "2026-08-20T18:02:00Z", "amount": 800 },
    { "type": "loyalty_accrued", "at": "2026-08-20T18:03:00Z", "amount": 40 },
    { "type": "training_attended", "at": "2026-08-19T16:00:00Z" }
  ]
}

Поля ответа

Объединить дубли

POST /users/merge

Объединяет две карточки одного человека, например заведённые по телефону и по email. Баллы, история и билеты переходят на primary_id, вторую карточку система помечает как объединённую.

Параметры

curl https://api.virazh.io/v1/users/merge \
  -X POST \
  -H "Authorization: Bearer sk_test_51H..." \
  -H "Content-Type: application/json" \
  -d '{ "primary_id": "usr_8f21c", "duplicate_id": "usr_11a90" }'

{
  "primary_id": "usr_8f21c",
  "merged_from": "usr_11a90",
  "points_merged": 210
}

Поля ответа

Полезно знать

• При создании пользователя основным идентификатором служит поле phone. Если зарегистрировать тот же номер повторно, метод вернёт существующего пользователя и дубликат не появится.
• Списки листаются через limit (до 100 записей за раз) и next_cursor из ответа. Пагинация по смещению (page=) не поддерживается.
• Мягкое удаление (DELETE /users/{id}) скрывает профиль из выборок и рассылок и сохраняет историю для отчётности. Обращения по праву на забвение поддержка клуба обрабатывает отдельно и вручную.
• Объединение дублей (/users/merge) необратимо. Вторая карточка получает отметку объединённой и теряет самостоятельный доступ, все баллы и билеты переходят на primary_id.