API attach UK: различия между версиями

Материал из WiKi - UserSide
(Add Ukrainian API docs and trilingual API links)
 
(Add Ukrainian API docs and trilingual API links)
 
(не показаны 3 промежуточные версии этого же участника)
Строка 1: Строка 1:
[[API_attach_EN|en]] | '''uk''' | [[API attach|ru]]
[[API_attach_EN|en]] | '''uk''' | [[API attach|ru]]


Розділ '''[[API]]''' ERP "UserSide"
Розділ '''[[API_UK|API]]''' ERP "UserSide"


Призначення: Дія с прикрепляемыми файлами
Призначення: Робота з прикріпленими файлами


  Додаткові параметри:
  Додаткові параметри:
Строка 13: Строка 13:
''Доопрацьовано у: 3.19.48 (додано параметр uuid)''
''Доопрацьовано у: 3.19.48 (додано параметр uuid)''


''Доопрацьовано у: 3.16.19 (додано параметри name и comment)''
''Доопрацьовано у: 3.16.19 (додано параметри name і comment)''


''Доопрацьовано у: 3.16dev4 (в параметр object_type добавлено возможное значення cable_line)''
''Доопрацьовано у: 3.16dev4 (до параметра object_type додано можливе значення cable_line)''


''Доопрацьовано у: 3.16dev2 (виключено параметр operator_id, додано параметр employee_id)''
''Доопрацьовано у: 3.16dev2 (виключено параметр operator_id, додано параметр employee_id)''


''Доопрацьовано у: 3.15.42 (в параметр object_type добавлено возможное значення inventory)''
''Доопрацьовано у: 3.15.42 (до параметра object_type додано можливе значення inventory)''


''Доопрацьовано у: 3.14.21 (в параметр object_type добавлено возможное значення customer)''
''Доопрацьовано у: 3.14.21 (до параметра object_type додано можливе значення customer)''


  Опис: Додавання файла к об'єкту
  Опис: Додавання файла к об'єкту
  Обов'язкові параметри:
  Обов'язкові параметри:
   object_type - тип об'єкта [cable_line|customer|node|task|task_comment|inventory]
   object_type - тип об'єкта [cable_line|customer|node|task|task_comment|inventory]
   object_id - id об'єкта, к которому прикреплять файл
   object_id - id об'єкта, до якого прикріплювати файл
   comment_id - id комментария к заданию, к которому прикреплять файл ''(для типа task_comment)''
   comment_id - id коментаря до завдання, до якого прикріплювати файл ''(для типу task_comment)''
   ЛИБО src - url к файлу, который требуется загрузить и прикрепить
   АБО src - url к файлу, який требуется загрузить і прикрепить
   ЛИБО uuid - uuid с иным файлом, который уже загружен и который требуется прикрепить к иному об'єкту
   АБО uuid - uuid с іншим файлом, який уже загружен і який требуется прикрепить к иному об'єкту
  Необов'язкові параметри:
  Необов'язкові параметри:
   employee_id - id співробітника, от имени которого добавить файл
   employee_id - id співробітника, від імені якого додати файл
   operator_id - id оператора, от имени которого добавить файл ''(до версии 3.16dev2)''
   operator_id - id оператора, від імені якого додати файл ''(до версії 3.16dev2)''
   name - имя файла ''(произвольный текст)''
   name - имя файла ''(довільний текст)''
   comment - нотатки/описание к файлу
   comment - нотатки/описание к файлу
   src_id - id метода/типа загрузки файла (произвольно, на усмотрение клиента)
   src_id - id метода/типа загрузки файла (произвольно, на усмотрение клієнта)


==== delete ====
==== delete ====
Строка 43: Строка 43:
  Опис: Видалення файла
  Опис: Видалення файла
  Обов'язкові параметри:
  Обов'язкові параметри:
   id - id файла ''(версии до 3.19)''
   id - id файла ''(версії до 3.19)''
   uuid - uuid файла ''(версия 3.19+)''
   uuid - uuid файла ''(версія 3.19+)''
   name - имя файла ''(без путей)''
   name - имя файла ''(без путей)''


==== get ====
==== get ====
''Доопрацьовано у: 3.20.23 (в параметр object_type добавлено возможное значення additional_field)''
''Доопрацьовано у: 3.20.23 (до параметра object_type додано можливе значення additional_field)''


''Доопрацьовано у: 3.19beta1 (виключено параметр id, додано параметр uuid)''
''Доопрацьовано у: 3.19beta1 (виключено параметр id, додано параметр uuid)''


''Доопрацьовано у: 3.16dev4 (в параметр object_type добавлено возможное значення cable_line)''
''Доопрацьовано у: 3.16dev4 (до параметра object_type додано можливе значення cable_line)''


''Доопрацьовано у: 3.15.42 (в параметр object_type добавлено возможное значення inventory)''
''Доопрацьовано у: 3.15.42 (до параметра object_type додано можливе значення inventory)''


''Доопрацьовано у: 3.15.12 (додано параметри object_type и object_id)''
''Доопрацьовано у: 3.15.12 (додано параметри object_type і object_id)''


''Доопрацьовано у: 3.14.41 (додано параметри ext_name и int_name)''
''Доопрацьовано у: 3.14.41 (додано параметри ext_name і int_name)''


''Додано з: 3.14.36''
''Додано з: 3.14.36''
  Опис: Отримання информации
  Опис: Отримання інформації
  Обов'язкові параметри ''(что-то одно)'':
  Обов'язкові параметри ''(що-то одно)'':
   uuid - uuid файла ''(можна через кому)'' ''(версии 3.19+)''
   uuid - uuid файла ''(можна через кому)'' ''(версії 3.19+)''
   id - id файла ''(можна через кому)'' ''(версии до 3.19)''
   id - id файла ''(можна через кому)'' ''(версії до 3.19)''
   ext_name - внешнее имя файла ''(исходное)''
   ext_name - внешнее имя файла ''(исходное)''
   int_name - внутреннее имя файла ''(как хранится в системе)''
   int_name - внутреннее имя файла ''(как хранится в системе)''
   object_type - тип об'єкта [additional_field|cable_line|customer|inventory|node|task|task_comment] ''(используется совместно с object_id)''
   object_type - тип об'єкта [additional_field|cable_line|customer|inventory|node|task|task_comment] ''(використовується совместно с object_id)''
   object_id - id/uuid об'єкта, к которому прикреплён файл ''(используется совместно с object_type)''
   object_id - id/uuid об'єкта, до якого прикріплений файл ''(використовується разом з object_type)''


==== get_file ====
==== get_file ====
Строка 75: Строка 75:
''Додано з: 3.14.57''
''Додано з: 3.14.57''


  Опис: Вывод содержимого файла ''(в бинарном виде)''
  Опис: Виведення содержимого файла ''(в бинарном виде)''
  Обов'язкові параметри:
  Обов'язкові параметри:
   uuid - uuid файла ''(версии 3.19+)''
   uuid - uuid файла ''(версії 3.19+)''
   id - id файла ''(версии до 3.19)''
   id - id файла ''(версії до 3.19)''


==== get_file_temporary_link ====
==== get_file_temporary_link ====
Строка 87: Строка 87:
  Опис: Предоставление прямой временной посилання на загрузку файла
  Опис: Предоставление прямой временной посилання на загрузку файла
  Обов'язкові параметри:
  Обов'язкові параметри:
   uuid - uuid файла ''(версии 3.19+)''
   uuid - uuid файла ''(версії 3.19+)''
   id - id файла ''(версии до 3.19)''
   id - id файла ''(версії до 3.19)''

Текущая версия от 10:49, 10 мая 2026

en | uk | ru

Розділ API ERP "UserSide"

Призначення: Робота з прикріпленими файлами 

Додаткові параметри:
action - підкатегорія запиту (можливе значення: див. нижче)

Підкатегорії

add

Доопрацьовано у: 3.19.48 (додано параметр uuid)

Доопрацьовано у: 3.16.19 (додано параметри name і comment)

Доопрацьовано у: 3.16dev4 (до параметра object_type додано можливе значення cable_line)

Доопрацьовано у: 3.16dev2 (виключено параметр operator_id, додано параметр employee_id)

Доопрацьовано у: 3.15.42 (до параметра object_type додано можливе значення inventory)

Доопрацьовано у: 3.14.21 (до параметра object_type додано можливе значення customer) 

Опис: Додавання файла к об'єкту
Обов'язкові параметри:
 object_type - тип об'єкта [cable_line|customer|node|task|task_comment|inventory]
 object_id - id об'єкта, до якого прикріплювати файл
 comment_id - id коментаря до завдання, до якого прикріплювати файл (для типу task_comment)
 АБО src - url к файлу, який требуется загрузить і прикрепить
 АБО uuid - uuid с іншим файлом, який уже загружен і який требуется прикрепить к иному об'єкту
Необов'язкові параметри:
 employee_id - id співробітника, від імені якого додати файл
 operator_id - id оператора, від імені якого додати файл (до версії 3.16dev2)
 name - имя файла (довільний текст)
 comment - нотатки/описание к файлу
 src_id - id метода/типа загрузки файла (произвольно, на усмотрение клієнта)

delete

Доопрацьовано у: 3.19beta1 (виключено параметр id, додано параметр uuid)

Додано з: 3.12beta25 

Опис: Видалення файла
Обов'язкові параметри:
 id - id файла (версії до 3.19)
 uuid - uuid файла (версія 3.19+)
 name - имя файла (без путей)

get

Доопрацьовано у: 3.20.23 (до параметра object_type додано можливе значення additional_field)

Доопрацьовано у: 3.19beta1 (виключено параметр id, додано параметр uuid)

Доопрацьовано у: 3.16dev4 (до параметра object_type додано можливе значення cable_line)

Доопрацьовано у: 3.15.42 (до параметра object_type додано можливе значення inventory)

Доопрацьовано у: 3.15.12 (додано параметри object_type і object_id)

Доопрацьовано у: 3.14.41 (додано параметри ext_name і int_name)

Додано з: 3.14.36 

Опис: Отримання інформації
Обов'язкові параметри (що-то одно):
 uuid - uuid файла (можна через кому) (версії 3.19+)
 id - id файла (можна через кому) (версії до 3.19)
 ext_name - внешнее имя файла (исходное)
 int_name - внутреннее имя файла (как хранится в системе)
 object_type - тип об'єкта [additional_field|cable_line|customer|inventory|node|task|task_comment] (використовується совместно с object_id)
 object_id - id/uuid об'єкта, до якого прикріплений файл (використовується разом з object_type)

get_file

Доопрацьовано у: 3.19beta1 (виключено параметр id, додано параметр uuid)

Додано з: 3.14.57 

Опис: Виведення содержимого файла (в бинарном виде)
Обов'язкові параметри:
 uuid - uuid файла (версії 3.19+)
 id - id файла (версії до 3.19)

get_file_temporary_link

Доопрацьовано у: 3.19beta1 (виключено параметр id, додано параметр uuid)

Додано з: 3.17dev1 

Опис: Предоставление прямой временной посилання на загрузку файла
Обов'язкові параметри:
 uuid - uuid файла (версії 3.19+)
 id - id файла (версії до 3.19)
Источник — https://wiki.userside.eu/index.php?title=API_attach_UK&oldid=21436