Управление записями через API

Как добавлять учеников в курсы программно.

Часто используемый сценарий: ученик оплатил курс на вашем внешнем сайте, и его нужно автоматически записать в 1Study. Это делается через Enterprise API.

Flow

1
Найдите или создайте клиента
POST /api/enterprise/v2/clients — с email / телефоном.
2
Запишите его в нужный курс или группу
POST /api/enterprise/v2/enrollments — с clientId и courseId/streamId.
3
Ученик автоматически получает приглашение
По email и/или WhatsApp — по настройкам школы.

Пример

curl -X POST "https://1study.one/api/enterprise/v2/enrollments" \
  -H "X-API-Key: ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "clientId": "uuid-клиента",
    "courseId": "uuid-курса"
  }'

Совет

Для интеграции с платёжной системой используйте вебхуки. Когда приходит платёж — в обработчике делайте запись через API. Это самый надёжный способ.

1study.one/docs/api

Enterprise API — пример запроса

Создание записи ученика в курс через API

# Запрос

POST /api/enterprise/v2/enrollments

# Заголовки

X-API-Key: ваш_ключ

Content-Type: application/json

# Тело

{

"clientId": "uuid-клиента",

"courseId": "uuid-курса"

}

Запись ученика в курс через API