REST API
GET/ api/ v1/ files/ { id}
Скачать собственное вложение.
| Поле | Значение |
|---|---|
| URL | GET |
| Доступ | Cookie кабинета · Mini App (TMA) |
| Scope для ключей | ключи не принимаются – только кабинет (403 CREDENTIAL_) |
| operationId | filesGet |
Описание#
Скачать только собственное вложение как attachment, с filename / filename*, Content-Length, nosniff и sandbox CSP. Содержимое бинарное либо UTF-8 для текста; чужой/неверный UUID – 404. ETag / 304 этим обработчиком не реализованы.
Auth: сессия кабинета (cookie) / TMA bearer. Scope: не требуется.
Path (обязателен каждый параметр):
| Поле | Тип | Обязательно | Ограничения |
|---|---|---|---|
id | string | да | формат "uuid"; pattern см. полную схему |
Query: нет объявленных полей.
Body: не требуется.
Ответ · статус и структура
Ответ: 200; бинарное тело image/, image/, image/, application/, text/, text/.
Ошибки: 401 , 403 , 503 , 429 , 404 , 403 ; общие ошибки.
Лимиты: Отдельного throttle в коде нет.
curl -sS -i https://aos.edgelab.space/api/v1/files/00000000-0000-4000-8000-000000000001 \
--cookie '__Host-aos_sess=SESSION_PLACEHOLDER'Ответы по контракту#
| Статус | Тип | Схема | Описание |
|---|---|---|---|
| 200 | image/png | – | Успех |
| 304 | – | – | Not Modified (If-None-Match matched the ETag) |
| ошибка | application/json | ErrorBody | Ошибка; коды: UNAUTHENTICATED, NO_ENTITLEMENT, ENTITLEMENT_UNAVAILABLE, RATE_LIMITED, NOT_FOUND |
Машиночитаемый контракт: openapi.json, операция filesGet.