К содержанию
AgentOSДокументация
  • Загружаем индекс…
llms.txtКабинет

REST API

POST/api/v1/auth/link/inspect

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

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

Описание#

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

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

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

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

Body: application/json, LinkTokenRequest. Все вложенные поля и варианты – по ссылке.

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

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

Ответ: 200 application/json, 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; общие ошибки.

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

СтатусТипСхемаОписание
200application/jsonLinkIdentityУспех
ошибкаapplication/jsonErrorBodyОшибка; коды: VALIDATION_FAILED, LINK_INVALID, ORIGIN_REJECTED, RATE_LIMITED

Машиночитаемый контракт: openapi.json, операция authLinkInspect.