ПланФикс API file.download — различия между версиями
Материал из ПланФикс
SliZzzZ (обсуждение | вклад) (→Перейти) |
Seva (обсуждение | вклад) |
||
| Строка 7: | Строка 7: | ||
<file> | <file> | ||
<id></id> | <id></id> | ||
| + | <uniqueId></uniqueId> | ||
</file> | </file> | ||
<signature></signature> | <signature></signature> | ||
| Строка 15: | Строка 16: | ||
|- | |- | ||
|file.id ||int ||идентификатор файла || | |file.id ||int ||идентификатор файла || | ||
| + | |- | ||
| + | |file.uniqueId ||int ||уникальный идентификатор файла || | ||
|- | |- | ||
|signature ||string(32) ||подпись || | |signature ||string(32) ||подпись || | ||
|- | |- | ||
|} | |} | ||
| + | При вызове функции можно использовать один из параметров '''id''' или '''uniqueId'''. Наличие параметра '''id''' исключает использование параметра '''uniqueId''' | ||
Результат выполнения функции расшифровывается по коду HTTP ответа | Результат выполнения функции расшифровывается по коду HTTP ответа | ||
| Строка 26: | Строка 30: | ||
| 200||тело ответа - файл || | | 200||тело ответа - файл || | ||
|- | |- | ||
| − | |403 ||доступ запрещен || | + | |403 ||доступ запрещен || тело ответа - стандартный XML-ответ с расшифровкой ошибки |
|- | |- | ||
| − | |404 ||такого файла не существует || | + | |404 ||такого файла не существует || тело ответа - стандартный XML-ответ с расшифровкой ошибки |
|- | |- | ||
|} | |} | ||
| + | |||
| + | Тело ответа с ошибкой: | ||
| + | <source lang="xml"> | ||
| + | <?xml version="1.0" encoding="UTF-8"?> | ||
| + | <response status="error"> | ||
| + | <code></code> | ||
| + | </response> | ||
| + | </source> | ||
| + | |||
== Перейти == | == Перейти == | ||
Версия 15:49, 13 декабря 2010
Функция скачивания файла. Формат запроса:
<?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 | тело ответа - файл | |
| 403 | доступ запрещен | тело ответа - стандартный XML-ответ с расшифровкой ошибки |
| 404 | такого файла не существует | тело ответа - стандартный XML-ответ с расшифровкой ошибки |
Тело ответа с ошибкой:
<?xml version="1.0" encoding="UTF-8"?>
<response status="error">
<code></code>
</response>