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

REST API

GET/api/v1/files/{id}

Скачать собственное вложение.

ПолеЗначение
URLGET https://aos.edgelab.space/api/v1/files/{id}
ДоступCookie кабинета · Mini App (TMA)
Scope для ключейключи не принимаются – только кабинет (403 CREDENTIAL_NOT_ALLOWED)
operationIdfilesGet

Описание#

Скачать только собственное вложение как attachment, с filename / filename*, Content-Length, nosniff и sandbox CSP. Содержимое бинарное либо UTF-8 для текста; чужой/неверный UUID – 404. ETag / 304 этим обработчиком не реализованы.

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

Path (обязателен каждый параметр):

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

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

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

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

Ответ: 200; бинарное тело image/png, image/jpeg, image/webp, application/pdf, text/plain, text/markdown.

Ошибки: 401 UNAUTHENTICATED, 403 NO_ENTITLEMENT, 503 ENTITLEMENT_UNAVAILABLE, 429 RATE_LIMITED, 404 NOT_FOUND, 403 CREDENTIAL_NOT_ALLOWED; общие ошибки.

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

bash
curl -sS -i https://aos.edgelab.space/api/v1/files/00000000-0000-4000-8000-000000000001 \
  --cookie '__Host-aos_sess=SESSION_PLACEHOLDER'

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

СтатусТипСхемаОписание
200image/png–Успех
304––Not Modified (If-None-Match matched the ETag)
ошибкаapplication/jsonErrorBodyОшибка; коды: UNAUTHENTICATED, NO_ENTITLEMENT, ENTITLEMENT_UNAVAILABLE, RATE_LIMITED, NOT_FOUND

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