REST API: Работа с файлами: различия между версиями
Материал из Planfix
Artem (обсуждение | вклад) Нет описания правки |
Artem (обсуждение | вклад) Нет описания правки |
||
| (не показано 9 промежуточных версий этого же участника) | |||
| Строка 1: | Строка 1: | ||
{{#seo: | |||
|title=REST API: Работа с файлами | |||
|titlemode=append | |||
|keywords=планфикс, апи, api, rest, rest api, файлы, работа с файлами, api работа с файлами | |||
|description=REST API: Работа с файлами | |||
}} | |||
[[REST API]] ПланФикса поддерживает работу с файлами. | [[REST API]] ПланФикса поддерживает работу с файлами. | ||
*[[#Прикрепить и обновить |Прикрепить и обновить]] | |||
*[[#Получить список файлов |Получить список файлов]] | |||
== Прикрепить и обновить == | == Прикрепить и обновить == | ||
Через API можно прикреплять или обновлять ранее загруженные файлы: | Через API можно прикреплять или обновлять ранее загруженные файлы в: | ||
*[[#Задача |Задачах]] | |||
*[[#Контакт |Контактах]] | |||
*[[#Проект |Проектах]] | |||
=== Задача === | === Задача === | ||
*Файлы крепятся или обновляются только в описании задачи. | *Файлы крепятся или обновляются только в описании задачи. | ||
*Прикрепить файлы к описанию во время создания задачи: | *Прикрепить файлы к описанию во время создания задачи: | ||
https://p.pfx.so/pf/6y/8jd89h.png | https://p.pfx.so/pf/6y/8jd89h.png | ||
*Обновить | *Обновить файлы в описании задачи: | ||
https://p.pfx.so/pf/Eg/dTxTaM.png | https://p.pfx.so/pf/Eg/dTxTaM.png | ||
| Строка 18: | Строка 29: | ||
'''Важно:''' | '''Важно:''' | ||
*Файлы заменяются теми, что переданы в параметре files. | *Файлы заменяются теми, что переданы в параметре files. | ||
*Если передан пустой массив, файлы будут откреплены от задачи и удалены, если нигде более не используются. *Если поле files передано не будет, файлы обновляться не будут. | *Если передан пустой массив, файлы будут откреплены от задачи и удалены, если нигде более не используются. | ||
*Если поле files передано не будет, файлы обновляться не будут. | |||
=== Контакт === | === Контакт === | ||
*Файлы крепятся или обновляются только в описании контакта. | |||
*Прикрепить файлы к описанию во время создания контакта: | |||
https://p.pfx.so/pf/i2/pKTt3M.png | |||
*Обновить файлы в описании контакта: | |||
https://p.pfx.so/pf/Iw/dejkxz.png | |||
'''Важно:''' | |||
*Файлы заменяются теми, что переданы в параметре files. | |||
*Если передан пустой массив, файлы будут откреплены от контакта и удалены, если нигде более не используются. | |||
*Если поле files передано не будет, файлы обновляться не будут. | |||
=== Проект === | === Проект === | ||
*Файлы крепятся или обновляются только в документах проекта. | |||
*Прикрепить файлы во время создания проекта: | |||
https://p.pfx.so/pf/6R/EKGUPU.png | |||
*Обновить файлы в проекте: | |||
https://p.pfx.so/pf/Wg/fsElGe.png | |||
'''Важно:''' | |||
*Файлы заменяются теми, что переданы в параметре files. | |||
*Если передан пустой массив, файлы будут откреплены от проекта и удалены, если нигде более не используются. | |||
*Если поле files передано не будет, файлы обновляться не будут. | |||
== Получить список файлов == | |||
Через API можно получить список файлов из: | |||
*[[#Задачи |Задачи]] | |||
*[[#Контакта |Контакта]] | |||
*[[#Проекта |Проекта]] | |||
=== Задачи === | |||
У метода есть параметр onlyFromDescription, который позволяет получать файлы только из описания задачи: | |||
https://p.pfx.so/pf/tu/IpVMnG.png | |||
=== Контакта === | |||
У метода есть параметр onlyFromDescription, который позволяет получать файлы только из описания контакта: | |||
https://p.pfx.so/pf/eh/PlMgOD.png | |||
=== Проекта === | |||
У метода есть параметры pageSize и offset, для постраничной навигации по списку: | |||
https://p.pfx.so/pf/oa/EmFu1e.png | |||
== Перейти == | |||
* | *[[REST API]] | ||
* | *[[API ПланФикса]] | ||
Текущая версия от 10:02, 22 июня 2023
REST API ПланФикса поддерживает работу с файлами.
Прикрепить и обновить
Через API можно прикреплять или обновлять ранее загруженные файлы в:
Задача
- Файлы крепятся или обновляются только в описании задачи.
- Прикрепить файлы к описанию во время создания задачи:
- Обновить файлы в описании задачи:
Важно:
- Файлы заменяются теми, что переданы в параметре files.
- Если передан пустой массив, файлы будут откреплены от задачи и удалены, если нигде более не используются.
- Если поле files передано не будет, файлы обновляться не будут.
Контакт
- Файлы крепятся или обновляются только в описании контакта.
- Прикрепить файлы к описанию во время создания контакта:
- Обновить файлы в описании контакта:
Важно:
- Файлы заменяются теми, что переданы в параметре files.
- Если передан пустой массив, файлы будут откреплены от контакта и удалены, если нигде более не используются.
- Если поле files передано не будет, файлы обновляться не будут.
Проект
- Файлы крепятся или обновляются только в документах проекта.
- Прикрепить файлы во время создания проекта:
- Обновить файлы в проекте:
Важно:
- Файлы заменяются теми, что переданы в параметре files.
- Если передан пустой массив, файлы будут откреплены от проекта и удалены, если нигде более не используются.
- Если поле files передано не будет, файлы обновляться не будут.
Получить список файлов
Через API можно получить список файлов из:
Задачи
У метода есть параметр onlyFromDescription, который позволяет получать файлы только из описания задачи:
Контакта
У метода есть параметр onlyFromDescription, который позволяет получать файлы только из описания контакта:
Проекта
У метода есть параметры pageSize и offset, для постраничной навигации по списку:
