Skip to main content

​
Заголовки запроса

​
Authorization
string
required
API токен сервисного пользователя в формате Bearer. Получите токен в панели администратора школы. Формат: Bearer YOUR_TOKEN.
​
Seller-Id
string
required
Уникальный идентификатор продавца в системе. Используется для разграничения доступа между разными продавцами.
​
School-Id
string
required
Уникальный идентификатор школы в системе. Определяет контекст выполнения операции.

​
Параметры запроса

При обновлении все поля необязательны для заполнения. Если поле необходимо удалить и оно может быть пустым — передавайте null
​
email
string
Email адрес пользователя. Должен быть валидным email форматом. При передаче пустой строки — преобразуется в null.
​
phone
string
Номер телефона пользователя. Должен быть в международном формате (например, +9876543210). При передаче пустой строки — преобразуется в null.
​
tgId
integer
Telegram ID пользователя. Целое число или null.
​
extId
string
Внешний идентификатор пользователя из вашей системы. Строка или null.
​
banned
boolean
Статус блокировки пользователя. При установке true все активные сессии пользователя будут завершены.

​
Параметры профиля

​
profile
object
Объект с данными профиля пользователя для обновления.
При обновлении пользователя можно изменить как основные данные, так и данные профиля. Если профиль не указан, то соответственно, он остается без изменений.
curl --location --request PUT 'https://api.exode.biz/saas/v2/user/123/update' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --data-raw '{
    "email": "[email protected]",
    "phone": "+9876543210",
    "extId": "crm_12345",
    "tgId": null,
    "banned": false,
    "profile": {
      "firstName": "UpdatedFirstname",
      "lastName": "UpdatedLastname",
      "bdate": "1990-01-01",
      "sex": "Men",
      "role": "Student"
    }
  }'

{
  "success": true,
  "code": 200,
  "payload": {
    "user": {
      "id": 123,
      "uuid": "550e8400-e29b-41d4-a716-446655440000",
      "active": true,
      "activated": true,
      "banned": false,
      "tgId": null,
      "domain": null,
      "email": "[email protected]",
      "phone": "+987654321",
      "language": null,
      "timezone": null,
      "lastOnlineAt": null,
      "starsBalance": 0,
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-15T11:45:00Z",
      "profile": {
        "id": 456,
        "firstName": "UpdatedFirstname",
        "lastName": "UpdatedLastname",
        "bdate": "1990-01-01",
        "sex": "Male",
        "role": "Student",
        "createdAt": "2024-01-15T10:30:00Z",
        "updatedAt": "2024-01-15T11:45:00Z"
      }
    }
  }
}

​
Требования к правам доступа

Для обновления пользователя требуется право на управление пользователями школы.
Сервисный пользователь должен быть аутентифицирован по токену и иметь соответствующие права доступа к указанной школе.
При установке статуса banned: true все активные сессии пользователя автоматически завершаются — это реализовано для обеспечения безопасности.