ПланФикс API handbook.getRecord — различия между версиями

Версия 10:48, 14 апреля 2018

Получение записи справочника. Формат запроса:

<?xml version="1.0" encoding="UTF-8"?>
<request method="handbook.getRecords">
  <account></account>
  <sid></sid>
  <handbook>
    <id></id>
  </handbook>
  <key></key>
  <signature></signature>
</request>

Название	Тип	Значение	Примечание
sid	string(32)	ключ сесии	выдается в результате прохождения аутентификации
handbook.id	int	идентификатор справочника
key	int	идентификатор записи

Ответ при успешном выполнении запроса:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
    <record>
      <parentKey></parentKey>
      <isGroup></isGroup>
      <key></key>
      <name></name>
      <customData>
        <customValue>
          <field>
            <id></id>
          </field>
          <value></value>
          <text></text>
        </customValue>
        <!-- -->
      </customData>
    </record>
</response>

Название	Тип	Значение
parentKey	int	идентификатор группы записей
isGroup	bool	является ли запись группой
key	int	идентификатор записи
name	string	название, если запись является группой
customData		данные записи
customData.customValue.field.id		идентификатор поля
customData.customValue.value		значение поля
customData.customValue.text		текстовое значение поля

В противном случае будет возвращен ответ с ошибкой:

<?xml version="1.0" encoding="UTF-8"?>
<response status="error">
  <code></code>
</response>

Перейти

@@ Строка 19: / Строка 19: @@
 |handbook.id|| int || идентификатор справочника ||
 |-
-|parentKey|| int || идентификатор записи ||
+|key|| int || идентификатор записи ||
 |-
 |}