Быстрый старт

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

Получите доступы

Владелец школы может создать API-ключ самостоятельно: раздел Управление → Школа → Для разработчиков → API-ключи (/manage/school/api-keys) — там создаётся сервисный пользователь (API-клиент) и выпускается токен. Если удобнее, напишите в поддержку — поможем с настройкой.Для запросов понадобятся три значения:

Authorization — API-токен (используется как Bearer <TOKEN>; показывается целиком только в момент создания или ротации — сохраните сразу);
Seller-Id — числовой ID продавца (аккаунта, которому принадлежит школа);
School-Id — числовой ID школы.

Оба ID есть на той же странице API-ключи в карточке «Данные для интеграции → Идентификаторы» — по клику копируется строка вида Seller-Id: 123; School-Id: 456.Сохраните значения в переменные окружения — их используют примеры ниже:

export EXODE_TOKEN='...'   # API token
export SELLER_ID=123       # Seller-Id
export SCHOOL_ID=456       # School-Id

Храните токен в переменных окружения, не в коде и не в репозитории.

Подготовьте заголовки

Все запросы выполняются с тремя обязательными заголовками:

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

string

обязательно

API-токен сервисного пользователя в формате Bearer YOUR_TOKEN. Токен выпускает владелец школы в кабинете: Управление → Школа → Для разработчиков → API-ключи — подробнее в разделе «Аутентификация».

integer

обязательно

Числовой ID продавца — аккаунта, которому принадлежит школа. Скопируйте его на странице API-ключи в карточке «Данные для интеграции → Идентификаторы». По этому ID проверяются права токена.

integer

обязательно

Числовой ID школы, берётся там же, где Seller-Id. Значение должно совпадать со школой продавца — иначе вернётся ошибка 400 с cause: "ForbiddenSchoolMismatch".

Сделайте первый запрос — найдите пользователя

Проверьте доступ безопасным методом чтения — user/find:

curl --location 'https://api.exode.biz/saas/v2/user/find?extId=crm_12345' \
  --header "Authorization: Bearer $EXODE_TOKEN" \
  --header "Seller-Id: $SELLER_ID" \
  --header "School-Id: $SCHOOL_ID"

const axios = require('axios');

const client = axios.create({
  baseURL: 'https://api.exode.biz/saas/v2',
  headers: {
    Authorization: `Bearer ${process.env.EXODE_TOKEN}`,
    'Seller-Id': process.env.SELLER_ID,
    'School-Id': process.env.SCHOOL_ID,
  },
});

const { data } = await client.get('/user/find', { params: { extId: 'crm_12345' } });
console.log(data.payload.user);

import os, requests

session = requests.Session()
session.headers.update({
  'Authorization': f"Bearer {os.environ['EXODE_TOKEN']}",
  'Seller-Id': os.environ['SELLER_ID'],
  'School-Id': os.environ['SCHOOL_ID'],
})

r = session.get('https://api.exode.biz/saas/v2/user/find', params={'extId': 'crm_12345'})
print(r.json()['payload']['user'])

extId — ваш собственный идентификатор пользователя (например, ID из CRM): строка до 50 символов без / и пробелов, уникальная в пределах школы. Если пользователь не найден, метод вернёт 200 и payload.user: null — это не ошибка.

На страницах методов в примерах cURL заголовки записаны как {{ sellerId }} и {{ schoolId }} — это переменные Postman-коллекции. В терминале подставьте вместо них числовые ID или $SELLER_ID и $SCHOOL_ID.

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

Если пользователя ещё нет — создайте его методом user/create. Логин и пароль будут отправлены пользователю автоматически, если есть канал доставки: email, phone (при подключённом SMS-провайдере) или tgId — подробности на странице метода.

cURL

curl --location 'https://api.exode.biz/saas/v2/user/create' \
  --header "Authorization: Bearer $EXODE_TOKEN" \
  --header "Seller-Id: $SELLER_ID" \
  --header "School-Id: $SCHOOL_ID" \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "email": "[email protected]",
    "extId": "crm_12345",
    "profile": { "firstName": "John", "lastName": "Doe" }
  }'

Разберите ответ

Любой ответ обёрнут в { success, code, payload }. Проверяйте success/code, а при ошибке — поле cause:

Успех

{ "success": true, "code": 200, "payload": { "user": { "id": 123, "extId": "crm_12345" } } }

Ошибка

{ "success": false, "code": 400, "cause": "EmailIsBusy", "message": "Email is busy", "error": "Email is busy" }

Здесь EmailIsBusy означает, что email уже занят другим пользователем школы. Обычно в этом случае ищут существующего пользователя через user/find?login=<email> или используют user/upsert, который создаёт или обновляет пользователя за один вызов.Подробно о заголовках, формате ответа, ошибках, rate-limit и пагинации — на странице «Работа с API».

Что дальше

Ключевые понятия

Как связаны продавец, школа, курсы, продукты и доступы.

Работа с API

Заголовки, формат ответа и ошибок, rate-limit, пагинация.

Вебхуки

Получайте события платформы в свои сервисы.

Объекты API

Полные структуры сущностей по zod-схемам.

Обновлено: 2026-09-25 13:43 UTC

Работа с API

Пользователи

Сотрудники (HR)

Группы

Курсы

Доступы и продажи

Отчеты и выгрузки

Кастомные поля

Формы

Нет нужного метода?

Все объекты

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

Что дальше

Ключевые понятия

Работа с API

Вебхуки

Объекты API

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

​Что дальше

Ключевые понятия

Работа с API

Вебхуки

Объекты API

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

Что дальше