# POST /api/v1/auth/oidc/start

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

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

## Описание

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

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

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

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

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

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

**Ответ:** 200 `application/json`, [OidcStartResponse](/docs/schemas#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`; [общие ошибки](/docs/errors).

**Лимиты:** Защита от перебора: при превышении – `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'
```

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

| Статус | Тип | Схема | Описание |
| --- | --- | --- | --- |
| 200 | application/json | [OidcStartResponse](/docs/schemas#oidcstartresponse) | OK (sets or clears a cookie) |
| ошибка | application/json | [ErrorBody](/docs/schemas#errorbody) | Ошибка; коды: ORIGIN_REJECTED, RATE_LIMITED, NOT_FOUND |

Машиночитаемый контракт: [openapi.json](/docs/openapi.json), операция `authOidcStart`.
