# POST /api/v1/auth/password/login

Войти по email и паролю.

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

## Описание

Войти по email и паролю; адрес сравнивается в нижнем регистре. Неверная пара или неизвестный email дают одинаковый `LOGIN_INVALID`.

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

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

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

**Body:** `application/json`, [PasswordLoginRequest](/docs/schemas#passwordloginrequest). Все вложенные поля и варианты – по ссылке.

| Поле       | Тип      | Обязательно | Ограничения                                           |
| ---------- | -------- | ----------- | ----------------------------------------------------- |
| `email`    | `string` | да          | длина ≤ 254; формат "email"; pattern см. полную схему |
| `password` | `string` | да          | длина ≥ 1; длина ≤ 128                                |

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

**Ответ:** 200 `application/json`, [Me](/docs/schemas#me).

Краткая форма: `{ student: Student, flow: "agentos3", tier: Tier, mentoring?: MentoringKind | null, offer?: Offer | null, access: { state: "active" | "grace", checkedAt: string }, onboarding: { status: OnboardingStatus, done: boolean }, planReady: boolean, authKind: "cookie" | "tma", features: { tutor: boolean, agentKeys: boolean, dictation: boolean }, limits: { tutorMessagesPerDay: integer, tutorUsdPerDay: number } }`.

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

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

```json
{
  "student": {
    "id": "0b9a6f2e-4c1d-4f7e-9a51-3c2d8e7f6a10",
    "tgId": 100000001,
    "name": "Александр Петров",
    "username": "alex_petrov",
    "avatarUrl": null
  },
  "flow": "agentos3",
  "tier": "personal",
  "access": {
    "state": "active",
    "checkedAt": "2026-11-04T09:00:00Z"
  },
  "onboarding": {
    "status": "draft",
    "done": false
  },
  "planReady": false,
  "authKind": "cookie",
  "features": {
    "tutor": false,
    "agentKeys": false,
    "dictation": true
  },
  "limits": {
    "tutorMessagesPerDay": 100,
    "tutorUsdPerDay": 2.5
  }
}
```

**Ошибки:** `422 VALIDATION_FAILED`, `403 ORIGIN_REJECTED`, `403 NO_ENTITLEMENT`, `503 ENTITLEMENT_UNAVAILABLE`, `429 RATE_LIMITED`, `401 LOGIN_INVALID`; [общие ошибки](/docs/errors).

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

**Запрос · JSON**

```json
{
  "email": "student@example.com",
  "password": "Example-password-123"
}
```

**Пример · curl**

```bash
curl -sS -i -X POST https://aos.edgelab.space/api/v1/auth/password/login \
  -H 'Origin: https://aos.edgelab.space' \
  -H 'Content-Type: application/json' \
  -d '{"email":"student@example.com","password":"Example-password-123"}'
```

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

Тело запроса: [PasswordLoginRequest](/docs/schemas#passwordloginrequest).

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

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