> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arzguard.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Скачать вложение

> Возвращает содержимое вложения в бинарном виде.

Возвращает содержимое вложения в бинарном виде.

Успешный ответ содержит байты файла, а не JSON. Получение уже привязанного вложения может учитывать его просмотр: обработчик вызывает `logAttachmentView`. Это относится и к GET-запросу. При совпавшем условном запросе `If-None-Match` обработчик выбирает ответ без повторной передачи файла. Не используйте универсальный JSON-парсер для бинарного ответа.

## Доступ

Передавайте `XF-Api-Key` в заголовке каждого запроса. [Типы ключей и выбор пользователя](https://docs.arzguard.com/guard-forum/authentication.md).

Требуемые scopes: `attachment:read`. Все перечисленные разрешения нужны одновременно.

Права текущего API-пользователя проверяются отдельно от scopes. Для Super key контекст задаётся заголовком `XF-Api-User`.

## Параметры

**XF-Api-Key** `string` *required*

Секретный API-ключ. В примерах ключ берётся из серверной переменной `$FORUM_API_KEY`.

**id** `integer` *required*

Идентификатор вложения.

**key** `string`

Секретный ключ набора временных вложений, полученный через `POST /attachments/new-key`. Это не API-ключ из заголовка.

**hash** `string`

Секретный временный hash вложения. Для ещё не привязанного файла нужен подходящий `hash` либо `key`; после привязки проверяются права на содержимое.

Для временного вложения передайте секретный `key` либо `hash` в query. Для уже прикреплённого файла эти значения не заменяют права на его содержимое.

## Ответ

[Схемы объектов и условные поля](https://docs.arzguard.com/guard-forum/models.md).

HTTP 200 с бинарным содержимым файла. JSON-обёртки нет.

Ошибки возвращаются в общей структуре `errors`. Обрабатывайте поле `code`; текст `message` может меняться или переводиться. [Формат ошибок](https://docs.arzguard.com/guard-forum/requests-and-errors.md).

```bash cURL theme={null}
curl --request GET 'https://forum.arzguard.com/api/attachments/123/data' \
  --header "XF-Api-Key: $FORUM_API_KEY" \
  --output 'example-attachment.bin'
```

```http 200 · бинарный ответ theme={null}
HTTP/1.1 200 OK

... байты файла ...
```

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.