Быстрый старт
Создайте персональный токен, проверьте доступ и выполните первый запрос.
1. Выпустите токен
Откройте Settings → API access в StackMoreLayers, задайте срок действия и выберите только необходимые области доступа. Токен действует от имени выпустившего его пользователя и не добавляет прав, которых нет в интерфейсе платформы.
Сохраните значение сразу: секретная часть повторно не показывается. Не передавайте токен в URL, аргументах процесса, задачах, выводе ноутбука или логах.
2. Проверьте токен
export SML_API_TOKEN="$TOKEN_FROM_SECRET_MANAGER"
curl --fail-with-body \
--header "Authorization: Bearer ${SML_API_TOKEN}" \
https://stackmorelayers.ai/api/v1/auth/whoami/Ответ содержит пользователя, тип токена, разрешённые области и срок действия. Сам токен в ответ не возвращается.
3. Прочитайте публичные данные
curl --fail-with-body \
--header "Authorization: Bearer ${SML_API_TOKEN}" \
"https://stackmorelayers.ai/api/v1/competitions/?page=1&page_size=20"Для интеграции учитывайте request_id, страницы результатов и HTTP-статус. Не разбирайте
текст message как машинный код — используйте error_code.
4. Выполните изменение с защитой от повторов
Операции создания и изменения, которые можно безопасно повторять, принимают
Idempotency-Key:
curl --fail-with-body \
--request POST \
--header "Authorization: Bearer ${SML_API_TOKEN}" \
--header "Content-Type: application/json" \
--header "Idempotency-Key: 0f6176bc-735f-4cbb-bbfd-a34610470ee8" \
--data @competition.json \
https://stackmorelayers.ai/api/v1/competitions/Повтор того же запроса с тем же ключом возвращает исходный результат. Нельзя переиспользовать ключ для другого тела запроса.