curl --request GET \
--header "Authorization: Bearer $PARTNER_TOKEN" \
--header 'X-Moderator-Provider: discord' \
--header 'X-Moderator-ID: 123456789012345678' \
--output material.png \
'https://test.crm.arzguard.com/api/partner/v1/personnel/materials/01910000-0000-7000-8000-000000000001?server_id=102&target_id=01910000-0000-7000-8000-000000000002'
Вложения
Получить кадровое доказательство
Возвращает байты приватного изображения PNG после проверки серверного контекста, полномочий модератора и доступа к вложению.
GET
/
api
/
partner
/
v1
/
personnel
/
materials
/
{id}
curl --request GET \
--header "Authorization: Bearer $PARTNER_TOKEN" \
--header 'X-Moderator-Provider: discord' \
--header 'X-Moderator-ID: 123456789012345678' \
--output material.png \
'https://test.crm.arzguard.com/api/partner/v1/personnel/materials/01910000-0000-7000-8000-000000000001?server_id=102&target_id=01910000-0000-7000-8000-000000000002'
Возвращает байты приватного изображения PNG после проверки серверного контекста, полномочий модератора и доступа к вложению. Требуется personnel:materials_read. Неприкреплённая загрузка доступна только загрузившему её боту и модератору. Прикреплённое кадровое доказательство проверяется по правам просмотра кадровой истории. Для отдельного доказательства чёрного списка передайте entry_id записи ЧС. Дополнительно нужны personnel:blacklist_read, права модератора на чтение ЧС и personnel:blacklist_global для глобальной записи.
См. формат ошибок и правила повторов.
Доступ
personnel:materials_read. CRM дополнительно проверяет доступ модератора к материалу.
Партнёрский Bearer-токен. Подробнее в разделе «Авторизация».
Параметры
Платформа модератора, выполнившего действие: discord или telegram. Допустимые значения
discord, telegram.ID модератора на выбранной платформе, строкой. Аккаунт должен быть подтверждён в CRM. До 20 символов.
Уникальный номер сервера из GET /api/partner/v1/servers или UUID сервера. Сервер должен входить в выданный боту доступ.
Идентификатор сотрудника в CRM, в том числе незарегистрированного участника состава (UUID).
Идентификатор записи чёрного списка (UUID), к которой относится доказательство. До 36 символов.
Успешный ответ
HTTP200. Запрос выполнен успешно.
Тело содержит байты изображения image/png. Сохраните ответ в файл.
Ошибки
| HTTP | Значение |
|---|---|
400 | Некорректные параметры запроса. |
401 | Токен отсутствует, недействителен, отозван или не разрешён для этого IP-адреса. |
403 | Недостаточно прав у бота или указанного модератора; сервер или функция не входят в выданный доступ. |
404 | Запись не найдена или недоступна в данном контексте. |
409 | Конфликт состояния или ключа идемпотентности. Получите актуальную ревизию перед новым действием. |
413 | Размер тела запроса или загружаемого файла превышает допустимый предел. |
422 | Данные не прошли проверку формата или ограничений. Подробности находятся в поле errors. |
429 | Превышен лимит запросов. Дождитесь интервала, указанного в заголовке Retry-After. |
500 | Внутренняя ошибка сервера. |
503 | Сервис временно недоступен. Повторите запрос позднее. |
Пример
В примере использованы условные идентификаторы.curl --request GET \
--header "Authorization: Bearer $PARTNER_TOKEN" \
--header 'X-Moderator-Provider: discord' \
--header 'X-Moderator-ID: 123456789012345678' \
--output material.png \
'https://test.crm.arzguard.com/api/partner/v1/personnel/materials/01910000-0000-7000-8000-000000000001?server_id=102&target_id=01910000-0000-7000-8000-000000000002'