К содержанию
AgentOSДокументация
  • Загружаем индекс…
llms.txtКабинет

REST API

POST/api/v1/auth/oidc/start

Начать Telegram Login OIDC: URL авторизации и cookie состояния на 10 минут.

ПолеЗначение
URLPOST https://aos.edgelab.space/api/v1/auth/oidc/start
ДоступБез авторизации
Scope для ключейне требуется
operationIdauthOidcStart

Описание#

Начать Telegram Login OIDC: URL авторизации и cookie состояния на 10 минут. Если OIDC не настроен, endpoint отвечает 404 NOT_FOUND до проверки лимита.

Auth: без авторизации. Scope: не требуется.

Path: параметров нет.

Query: нет объявленных полей.

Body: не требуется.

Ответ · статус и структура

Ответ: 200 application/json, OidcStartResponse.

Краткая форма: { authorizeUrl: string }.

Устанавливает или очищает cookie входа; login создаёт __Host-aos_sess на 30 дней (фактический срок сессии дополнительно проверяет БД).

Пример JSON; значения демонстрационные.

json
{
  "authorizeUrl": "https://oauth.telegram.org/auth?response_type=code&client_id=0000000000&redirect_uri=https%3A%2F%2Faos.edgelab.space%2Fauth%2Foidc%2Fcallback&scope=openid%20profile&state=STATE&nonce=NONCE&code_challenge=CHALLENGE&code_challenge_method=S256"
}

Ошибки: 403 ORIGIN_REJECTED, 429 RATE_LIMITED, 404 NOT_FOUND; общие ошибки.

Лимиты: Защита от перебора: при превышении – 429 RATE_LIMITED, повторить после Retry-After.

bash
curl -sS -i -X POST https://aos.edgelab.space/api/v1/auth/oidc/start \
  -H 'Origin: https://aos.edgelab.space'

Ответы по контракту#

СтатусТипСхемаОписание
200application/jsonOidcStartResponseOK (sets or clears a cookie)
ошибкаapplication/jsonErrorBodyОшибка; коды: ORIGIN_REJECTED, RATE_LIMITED, NOT_FOUND

Машиночитаемый контракт: openapi.json, операция authOidcStart.