# GET /api/v1/files/{id}

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

| Поле | Значение |
| --- | --- |
| URL | `GET https://aos.edgelab.space/api/v1/files/{id}` |
| Доступ | Cookie кабинета · Mini App (TMA) |
| Scope для ключей | ключи не принимаются – только кабинет (403 `CREDENTIAL_NOT_ALLOWED`) |
| 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/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`; [общие ошибки](/docs/errors).

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

```bash
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](/docs/schemas#errorbody) | Ошибка; коды: UNAUTHENTICATED, NO_ENTITLEMENT, ENTITLEMENT_UNAVAILABLE, RATE_LIMITED, NOT_FOUND |

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