ПланФикс API file.download
Материал из Planfix
Функция скачивания файла. Формат запроса:
<?xml version="1.0" encoding="UTF-8"?>
<request method="file.download">
<account></account>
<sid></sid>
<file>
<id></id>
<uniqueId></uniqueId>
</file>
<signature></signature>
</request>| Название | Тип | Значение | Примечание |
|---|---|---|---|
| file.id | int | идентификатор файла | |
| file.uniqueId | int | уникальный идентификатор файла | |
| signature | string(32) | подпись |
При вызове функции можно использовать один из параметров id или uniqueId. Наличие параметра id исключает использование параметра uniqueId
Результат выполнения функции расшифровывается по коду HTTP ответа
| Значение | Описание | Примечание |
|---|---|---|
| 200 | тело ответа - файл | |
| 302 | прямая ссылка на файл находится в заголовке Location | |
| 403 | доступ запрещен | тело ответа - стандартный XML-ответ с расшифровкой ошибки |
| 404 | такого файла не существует | тело ответа - стандартный XML-ответ с расшифровкой ошибки |
Тело ответа с ошибкой:
<?xml version="1.0" encoding="UTF-8"?>
<response status="error">
<code></code>
</response>