ПланФикс API handbook.addRecord: различия между версиями
Материал из Planfix
Seva (обсуждение | вклад) (Новая страница: «Создание записи справочника. Формат запроса: <source lang="xml"> <?xml version="1.0" encoding="UTF-8"?> <request method="han…») |
Seva (обсуждение | вклад) Нет описания правки |
||
Строка 34: | Строка 34: | ||
|name||string ||название, если запись является группой || | |name||string ||название, если запись является группой || | ||
|- | |- | ||
|customData|| ||значения полей | |customData|| ||значения полей || | ||
|- | |- | ||
|customData.customValue.id|| ||идентификатор поля || | |customData.customValue.id|| ||идентификатор поля || |
Версия от 10:32, 4 апреля 2018
Создание записи справочника. Формат запроса:
<?xml version="1.0" encoding="UTF-8"?>
<request method="handbook.addRecord">
<account></account>
<sid></sid>
<handbook>
<id></id>
</handbook>
<parentKey></parentKey>
<isGroup></isGroup>
<name></name>
<customData>
<customValue>
<id></id>
<value></value>
</customValue>
<!-- ... -->
</customData>
<signature></signature>
</request>
Название | Тип | Значение | Примечание |
---|---|---|---|
sid | string(32) | ключ сесии | выдается в результате прохождения аутентификации |
handbook.id | int | идентификатор справочника | |
parentKey | int | идентификатор группы записей | необязательный параметр |
isGroup | bool | является ли запись группой | |
name | string | название, если запись является группой | |
customData | значения полей | ||
customData.customValue.id | идентификатор поля | ||
customData.customValue.value | значение поля | (для полей типа набор задач, список сотрудников, набор записей справочника - идентификаторы через запятую в квадратных скобках) |
Ответ при успешном выполнении запроса:
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
<key></key>
</response>
Название | Тип | Значение | Примечание |
---|---|---|---|
key | int | идентификатор записи |
В противном случае будет возвращен ответ с ошибкой:
<?xml version="1.0" encoding="UTF-8"?>
<response status="error">
<code></code>
</response>