Аутентификация Enterprise API

Как получить токен и правильно авторизоваться.

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

Получение ключа

1
Откройте «Настройки» → «API / Разработчикам».
2
Нажмите «Сгенерировать ключ».
3
Скопируйте ключ сразу — потом он не будет показан целиком
Если потеряли — нужно сгенерировать новый, старый деактивируется.

Как авторизоваться

В каждом запросе передавайте заголовки: X-API-Key (ваш ключ) и Bearer токен (отдельный токен для мобильных клиентов, если используется). Полная схема — в Enterprise API документации.

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

curl -X GET "https://1study.one/api/enterprise/v2/courses" \
  -H "X-API-Key: ваш_ключ"

Внимание

Никогда не публикуйте API-ключ в открытом коде, на GitHub, в документации. Используйте переменные окружения.

1study.one/docs/api

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

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

# Запрос

POST /api/enterprise/v2/enrollments

# Заголовки

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

Content-Type: application/json

# Тело

{

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

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

}

Пример авторизации в API