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

Версия от 08:35, 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)

@@ Строка 13: / Строка 13: @@
 ''Доопрацьовано у: 3.19.48 (додано параметр uuid)''
-''Доопрацьовано у: 3.16.19 (додано параметри name и comment)''
+''Доопрацьовано у: 3.16.19 (додано параметри name і comment)''
 ''Доопрацьовано у: 3.16dev4 (в параметр object_type добавлено возможное значення cable_line)''
@@ Строка 27: / Строка 27: @@
    object_type - тип об'єкта [cable_line|customer|node|task|task_comment|inventory]
    object_id - id об'єкта, к которому прикреплять файл
-   comment_id - id комментария к заданию, к которому прикреплять файл ''(для типа task_comment)''
+   comment_id - id комментария до завдання, к которому прикреплять файл ''(для типа task_comment)''
-   ЛИБО src - url к файлу, который требуется загрузить и прикрепить
+   ЛИБО src - url к файлу, который требуется загрузить і прикрепить
-   ЛИБО uuid - uuid с иным файлом, который уже загружен и который требуется прикрепить к иному об'єкту
+   ЛИБО uuid - uuid с иным файлом, который уже загружен і который требуется прикрепить к иному об'єкту
   Необов'язкові параметри:
    employee_id - id співробітника, от имени которого добавить файл
-   operator_id - id оператора, от имени которого добавить файл ''(до версии 3.16dev2)''
+   operator_id - id оператора, от имени которого добавить файл ''(до версії 3.16dev2)''
    name - имя файла ''(произвольный текст)''
    comment - нотатки/описание к файлу
-   src_id - id метода/типа загрузки файла (произвольно, на усмотрение клиента)
+   src_id - id метода/типа загрузки файла (произвольно, на усмотрение клієнта)
 ==== delete ====
@@ Строка 43: / Строка 43: @@
   Опис: Видалення файла
   Обов'язкові параметри:
-   id - id файла ''(версии до 3.19)''
+   id - id файла ''(версії до 3.19)''
    uuid - uuid файла ''(версия 3.19+)''
    name - имя файла ''(без путей)''
@@ Строка 56: / Строка 56: @@
 ''Доопрацьовано у: 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''
   Опис: Отримання информации
-  Обов'язкові параметри ''(что-то одно)'':
+  Обов'язкові параметри ''(що-то одно)'':
-   uuid - uuid файла ''(можна через кому)'' ''(версии 3.19+)''
+   uuid - uuid файла ''(можна через кому)'' ''(версії 3.19+)''
-   id - id файла ''(можна через кому)'' ''(версии до 3.19)''
+   id - id файла ''(можна через кому)'' ''(версії до 3.19)''
    ext_name - внешнее имя файла ''(исходное)''
    int_name - внутреннее имя файла ''(как хранится в системе)''
@@ Строка 77: / Строка 77: @@
   Опис: Вывод содержимого файла ''(в бинарном виде)''
   Обов'язкові параметри:
-   uuid - uuid файла ''(версии 3.19+)''
+   uuid - uuid файла ''(версії 3.19+)''
-   id - id файла ''(версии до 3.19)''
+   id - id файла ''(версії до 3.19)''
 ==== get_file_temporary_link ====
@@ Строка 87: / Строка 87: @@
   Опис: Предоставление прямой временной посилання на загрузку файла
   Обов'язкові параметри:
-   uuid - uuid файла ''(версии 3.19+)''
+   uuid - uuid файла ''(версії 3.19+)''
-   id - id файла ''(версии до 3.19)''
+   id - id файла ''(версії до 3.19)''