Задача
Отправим файл на сервер, получим его идентификатор и прикрепим этот файл к описанию новой заявки.
Решение
Для примера будем использовать приложение Postman. Выполним необходимые настройки и отправим файл.
POST https://apigw.intradesk.ru/files/api/tasks/0/files/target/Description?ApiKey=65247DBDE14C45A6A275DC1FC0
Ответ сервера:
[
{
"id":"604b6c742d34af0001f26723", //идентификатор загруженного файла
"entityType":"task", //тип объекта, к которому приложен файл. Task – заявка, kb - статья базы знаний
"entityId":0, //идентификатор объекта, к которому прикрепляется файл. Для отдельно загружаемых файлов – 0.
"name":"ButAtt (2).jpg", //имя файла
"contentType":"image/png", //тип файла
"size":15581, //размер файла в байтах
"target":20, //куда прикладывается файл. 20 – комментарий, 30 – описание, 40 – доп.поле с типой «файл»
"uploadedAt":"2021-03-12T13:28:20.435Z", //дата загрузки
"uploadedBy":"Супервизор" //автор загрузки
}
]
Далее создаем заявку, прикладываем отправленные на сервер файлы.
POST https://apigw.intradesk.ru/changes/v3/tasks?ApiKey=65247DBDE14C45A6A275DC1FC0
Тело запроса:
{
"blocks":{
"tasktype":"{\"value\":36283}",
"name":"{\"value\":\"Почистить снег\"}",
"priority":"{\"value\":75707}",
"description":"{\"value\":\"Ночью выпало много снега, нужно почистить двор 25 дома\"}",
"service":"{\"value\":\"115434/115438/\"}",
"attachments":"{\"value\":{\"addFiles\":[{\"name\":\"ButAtt.jpg\",\"id\":\"604b6c742d34af0001f26723\",\"contentType\":\"image/jpeg\",\"size\":43558,\"target\":20,\"uploadedAt\":\"2021-03-12T13:28:20.435Z \",\"uploadedBy\":\" Супервизор \"}],\"deleteFileIds\":[]}}"
}
}
Ответ сервера:
Получаем статус-код 201 (успешное создание) и данные о только что созданной заявке
Далее можем зайти на клиентский портал и убедиться, что была создана новая заявка, а к её описанию прикреплен файл
Полная документация к методу в формате swagger (Files API)
Другие возможные параметры
Для загрузки файлов для описания:
POST https://apigw.intradesk.ru/files/api/tasks/0/files/target/Description?ApiKey=65247DBDE14C45A6A275DC1FC0
Нужно использовать multipart-запросы.
Все загруженные файлы нужно указать в запросе создания/изменения заявки в теле, в блоке "attachments". Выполнить запрос к API для создания/изменения заявок. Подробнее о создании и изменении заявок в статьях.
POST https://apigw.intradesk.ru/changes/v3/tasks- для новых заявок
PUT https://apigw.intradesk.ru/changes/v3/tasks - для существующих заявок
