# POST /api/v1/auth/link/inspect

Проверить, в чей кабинет ведёт одноразовая ссылка из бота.

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

## Описание

Проверить, в чей кабинет ведёт одноразовая ссылка из бота; токен не расходуется. `current` показывает текущий аккаунт, если он отличается; маленький cached avatar может быть встроен в ответ.

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

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

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

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

| Поле    | Тип      | Обязательно | Ограничения              |
| ------- | -------- | ----------- | ------------------------ |
| `token` | `string` | да          | pattern см. полную схему |

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

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

Краткая форма: `{ target: { displayName: string, username: string | null, avatar: string | null }, current: { displayName: string, username: string | null } | null, expiresAt: string }`.

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

```json
{
  "target": {
    "displayName": "Александр Петров",
    "username": "alex_petrov",
    "avatar": "data:image/webp;base64,UklGRkYAAABXRUJQVlA4TDoAAAAvH8AFAA9wROQr+F7BY/6jBWraRpKgL7SFshCu/O9cH4OI/tfh8S53szu90YpKMggPFxsdDYVE4BcD"
  },
  "current": null,
  "expiresAt": "2026-11-04T09:05:00Z"
}
```

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

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

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

```json
{
  "token": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
}
```

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

```bash
curl -sS -i -X POST https://aos.edgelab.space/api/v1/auth/link/inspect \
  -H 'Origin: https://aos.edgelab.space' \
  -H 'Content-Type: application/json' \
  -d '{"token":"AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"}'
```

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

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

| Статус | Тип | Схема | Описание |
| --- | --- | --- | --- |
| 200 | application/json | [LinkIdentity](/docs/schemas#linkidentity) | Успех |
| ошибка | application/json | [ErrorBody](/docs/schemas#errorbody) | Ошибка; коды: VALIDATION_FAILED, LINK_INVALID, ORIGIN_REJECTED, RATE_LIMITED |

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