REST API: Работа с файлами: различия между версиями

Материал из Planfix
Перейти к: навигация, поиск
Нет описания правки
Нет описания правки
Строка 1: Строка 1:
{{#seo:
|title=REST API: Работа с файлами
|titlemode=append
|keywords=планфикс, апи, api, rest, rest api, файлы, работа с файлами, api работа с файлами 
|description=REST API: Работа с файлами
}}
[[REST API]] ПланФикса поддерживает работу с файлами.
[[REST API]] ПланФикса поддерживает работу с файлами.


Строка 11: Строка 17:
*Файлы крепятся или обновляются только в описании задачи.  
*Файлы крепятся или обновляются только в описании задачи.  
*Прикрепить файлы к описанию во время создания задачи:
*Прикрепить файлы к описанию во время создания задачи:
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


Строка 29: Строка 33:
*Файлы крепятся или обновляются только в описании контакта.  
*Файлы крепятся или обновляются только в описании контакта.  
*Прикрепить файлы к описанию во время создания контакта:
*Прикрепить файлы к описанию во время создания контакта:
https://p.pfx.so/pf/i2/pKTt3M.png
https://p.pfx.so/pf/i2/pKTt3M.png




*Обновить файлы в описании контакта:
*Обновить файлы в описании контакта:
https://p.pfx.so/pf/Iw/dejkxz.png
https://p.pfx.so/pf/Iw/dejkxz.png


Строка 47: Строка 49:
*Файлы крепятся или обновляются только в документах проекта.  
*Файлы крепятся или обновляются только в документах проекта.  
*Прикрепить файлы во время создания проекта:
*Прикрепить файлы во время создания проекта:
https://p.pfx.so/pf/6R/EKGUPU.png
https://p.pfx.so/pf/6R/EKGUPU.png




*Обновить файлы в проекте:
*Обновить файлы в проекте:
https://p.pfx.so/pf/Wg/fsElGe.png
https://p.pfx.so/pf/Wg/fsElGe.png


Строка 60: Строка 60:
*Если передан пустой массив, файлы будут откреплены от проекта и удалены, если нигде более не используются.
*Если передан пустой массив, файлы будут откреплены от проекта и удалены, если нигде более не используются.
*Если поле 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:00, 22 июня 2023

REST API ПланФикса поддерживает работу с файлами.

Прикрепить и обновить

Через API можно прикреплять или обновлять ранее загруженные файлы в:


Задача

  • Файлы крепятся или обновляются только в описании задачи.
  • Прикрепить файлы к описанию во время создания задачи:

8jd89h.png


  • Обновить файлы в описании задачи:

dTxTaM.png


Важно:

  • Файлы заменяются теми, что переданы в параметре files.
  • Если передан пустой массив, файлы будут откреплены от задачи и удалены, если нигде более не используются.
  • Если поле files передано не будет, файлы обновляться не будут.


Контакт

  • Файлы крепятся или обновляются только в описании контакта.
  • Прикрепить файлы к описанию во время создания контакта:

pKTt3M.png


  • Обновить файлы в описании контакта:

dejkxz.png


Важно:

  • Файлы заменяются теми, что переданы в параметре files.
  • Если передан пустой массив, файлы будут откреплены от контакта и удалены, если нигде более не используются.
  • Если поле files передано не будет, файлы обновляться не будут.


Проект

  • Файлы крепятся или обновляются только в документах проекта.
  • Прикрепить файлы во время создания проекта:

EKGUPU.png


  • Обновить файлы в проекте:

fsElGe.png


Важно:

  • Файлы заменяются теми, что переданы в параметре files.
  • Если передан пустой массив, файлы будут откреплены от проекта и удалены, если нигде более не используются.
  • Если поле files передано не будет, файлы обновляться не будут.


Получить список файлов

Через API можно получить список файлов из: Задачи Контакта Проекта


Задачи

У метода есть параметр onlyFromDescription, который позволяет получать файлы только из описания задачи: IpVMnG.png


Контакта

У метода есть параметр onlyFromDescription, который позволяет получать файлы только из описания контакта: PlMgOD.png


Проекта

У метода есть параметры pageSize и offset, для постраничной навигации по списку: EmFu1e.png


Перейти