# GET /api/v1/auth/password

Прочитать статус пароля и почты.

| Поле | Значение |
| --- | --- |
| URL | `GET https://aos.edgelab.space/api/v1/auth/password` |
| Доступ | Cookie кабинета · Mini App (TMA) |
| Scope для ключей | ключи не принимаются – только кабинет (403 `CREDENTIAL_NOT_ALLOWED`) |
| operationId | `authPasswordStatus` |

## Описание

Прочитать статус пароля и почты. `orderEmail` – адрес собственного заказа, `orderEmailMasked` – только маска привязанного заказа; после привязки login email оба поля пусты.

**Auth:** сессия кабинета (cookie) / TMA bearer. **Scope:** не требуется.

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

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

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

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

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

Краткая форма: `{ email: string | null, hasPassword: boolean, mailEnabled: boolean, orderEmail: string | null, orderEmailMasked: string | null }`.

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

```json
{
  "email": "alex@example.com",
  "hasPassword": true,
  "mailEnabled": true,
  "orderEmail": null,
  "orderEmailMasked": null
}
```

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

**Лимиты:** Отдельного throttle в коде нет.

```bash
curl -sS -i https://aos.edgelab.space/api/v1/auth/password \
  --cookie '__Host-aos_sess=SESSION_PLACEHOLDER'
```

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

| Статус | Тип | Схема | Описание |
| --- | --- | --- | --- |
| 200 | application/json | [PasswordStatus](/docs/schemas#passwordstatus) | Успех |
| ошибка | application/json | [ErrorBody](/docs/schemas#errorbody) | Ошибка; коды: UNAUTHENTICATED, NO_ENTITLEMENT, ENTITLEMENT_UNAVAILABLE, RATE_LIMITED |

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