REST API
POST/ api/ v1/ auth/ oidc/ start
Начать Telegram Login OIDC: URL авторизации и cookie состояния на 10 минут.
| Поле | Значение |
|---|---|
| URL | POST |
| Доступ | Без авторизации |
| Scope для ключей | не требуется |
| operationId | authOidcStart |
Описание#
Начать Telegram Login OIDC: URL авторизации и cookie состояния на 10 минут. Если OIDC не настроен, endpoint отвечает 404 до проверки лимита.
Auth: без авторизации. Scope: не требуется.
Path: параметров нет.
Query: нет объявленных полей.
Body: не требуется.
Ответ · статус и структура
Ответ: 200 application/, OidcStartResponse.
Краткая форма: {.
Устанавливает или очищает cookie входа; login создаёт _ на 30 дней (фактический срок сессии дополнительно проверяет БД).
Пример 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 , 429 , 404 ; общие ошибки.
Лимиты: Защита от перебора: при превышении – 429 , повторить после Retry-.
curl -sS -i -X POST https://aos.edgelab.space/api/v1/auth/oidc/start \
-H 'Origin: https://aos.edgelab.space'Ответы по контракту#
| Статус | Тип | Схема | Описание |
|---|---|---|---|
| 200 | application/json | OidcStartResponse | OK (sets or clears a cookie) |
| ошибка | application/json | ErrorBody | Ошибка; коды: ORIGIN_REJECTED, RATE_LIMITED, NOT_FOUND |
Машиночитаемый контракт: openapi.json, операция authOidcStart.