REST API
POST/ api/ v1/ auth/ link/ inspect
Проверить, в чей кабинет ведёт одноразовая ссылка из бота.
| Поле | Значение |
|---|---|
| URL | POST |
| Доступ | Без авторизации |
| Scope для ключей | не требуется |
| operationId | authLinkInspect |
Описание#
Проверить, в чей кабинет ведёт одноразовая ссылка из бота; токен не расходуется. current показывает текущий аккаунт, если он отличается; маленький cached avatar может быть встроен в ответ.
Auth: без авторизации. Scope: не требуется.
Path: параметров нет.
Query: нет объявленных полей.
Body: application/, LinkTokenRequest. Все вложенные поля и варианты – по ссылке.
| Поле | Тип | Обязательно | Ограничения |
|---|---|---|---|
token | string | да | pattern см. полную схему |
Ответ · статус и структура
Ответ: 200 application/, LinkIdentity.
Краткая форма: {.
Пример 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 , 401 , 403 , 429 ; общие ошибки.
Лимиты: Защита от перебора: при превышении – 429 , повторить после Retry-.
Запрос · JSON
{
"token": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
}Пример · curl
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.
| Статус | Тип | Схема | Описание |
|---|---|---|---|
| 200 | application/json | LinkIdentity | Успех |
| ошибка | application/json | ErrorBody | Ошибка; коды: VALIDATION_FAILED, LINK_INVALID, ORIGIN_REJECTED, RATE_LIMITED |
Машиночитаемый контракт: openapi.json, операция authLinkInspect.