curl --request POST \
--header "Authorization: Bearer $PARTNER_TOKEN" \
--header 'X-Moderator-Provider: discord' \
--header 'X-Moderator-ID: 123456789012345678' \
--header 'Content-Type: image/png' \
--data-binary '@evidence.png' \
'https://test.crm.arzguard.com/api/partner/v1/personnel/materials/upload?server_id=102&target_id=01910000-0000-7000-8000-000000000002'
{
"content_type": "image/png",
"expires_at": "2026-11-16T13:00:00+03:00",
"id": "01910000-0000-7000-8000-000000000001",
"size": 54817
}
Вложения
Загрузить кадровое доказательство
Загружает PNG или JPEG размером до 5 МиБ.
POST
/
api
/
partner
/
v1
/
personnel
/
materials
/
upload
curl --request POST \
--header "Authorization: Bearer $PARTNER_TOKEN" \
--header 'X-Moderator-Provider: discord' \
--header 'X-Moderator-ID: 123456789012345678' \
--header 'Content-Type: image/png' \
--data-binary '@evidence.png' \
'https://test.crm.arzguard.com/api/partner/v1/personnel/materials/upload?server_id=102&target_id=01910000-0000-7000-8000-000000000002'
{
"content_type": "image/png",
"expires_at": "2026-11-16T13:00:00+03:00",
"id": "01910000-0000-7000-8000-000000000001",
"size": 54817
}
Загружает PNG или JPEG размером до 5 МиБ. Изображение нормализуется в PNG. Тело запроса содержит байты файла. Модератор передаётся в X-Moderator-Provider и X-Moderator-ID и должен иметь право снятия сотрудника в CRM. Требуется personnel:materials_write. Загрузка привязана к боту, модератору, сотруднику и серверу. Полученный id используется в attachment_ids снятия или его записи ЧС. Для прикрепления также требуется действующий personnel:materials_write. Неприкреплённая загрузка действует до expires_at. Максимум 20 незакреплённых загрузок на модератора.
Передайте байты файла в теле запроса. Поддерживаются
См. формат ошибок и правила повторов.
Доступ
personnel:materials_write. Модератору требуется право на снятие сотрудника в CRM.
Партнёрский Bearer-токен. Подробнее в разделе «Авторизация».
Параметры
Платформа модератора, выполнившего действие: discord или telegram. Допустимые значения
discord, telegram.ID модератора на выбранной платформе, строкой. Аккаунт должен быть подтверждён в CRM. До 20 символов.
Уникальный номер сервера из GET /api/partner/v1/servers или UUID сервера. Сервер должен входить в выданный боту доступ.
Идентификатор сотрудника в CRM, в том числе незарегистрированного участника состава (UUID).
MIME-тип файла: при загрузке — image/png или image/jpeg. При получении доказательства — image/png.
image/png и image/jpeg.
Успешный ответ
HTTP201. Запись создана.
Срок действия загрузки до её прикрепления к кадровому действию.Формат
date-time.Ошибки
| HTTP | Значение |
|---|---|
400 | Некорректные параметры запроса. |
401 | Токен отсутствует, недействителен, отозван или не разрешён для этого IP-адреса. |
403 | Недостаточно прав у бота или указанного модератора; сервер или функция не входят в выданный доступ. |
404 | Запись не найдена или недоступна в данном контексте. |
409 | Конфликт состояния или ключа идемпотентности. Получите актуальную ревизию перед новым действием. |
413 | Размер тела запроса или загружаемого файла превышает допустимый предел. |
422 | Данные не прошли проверку формата или ограничений. Подробности находятся в поле errors. |
429 | Превышен лимит запросов. Дождитесь интервала, указанного в заголовке Retry-After. |
500 | Внутренняя ошибка сервера. |
503 | Сервис временно недоступен. Повторите запрос позднее. |
Пример
В примере использованы условные идентификаторы.curl --request POST \
--header "Authorization: Bearer $PARTNER_TOKEN" \
--header 'X-Moderator-Provider: discord' \
--header 'X-Moderator-ID: 123456789012345678' \
--header 'Content-Type: image/png' \
--data-binary '@evidence.png' \
'https://test.crm.arzguard.com/api/partner/v1/personnel/materials/upload?server_id=102&target_id=01910000-0000-7000-8000-000000000002'
{
"content_type": "image/png",
"expires_at": "2026-11-16T13:00:00+03:00",
"id": "01910000-0000-7000-8000-000000000001",
"size": 54817
}