ПланФикс API handbook.getRecordMulti

Материал из Planfix
Версия от 11:51, 6 июля 2021; Seva (обсуждение | вклад)
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)
Перейти к: навигация, поиск

Функция получения множества записей справочника по их идентификаторам. Позволяет получить данные до 100 записей за запрос. Формат запроса:

<?xml version="1.0" encoding="UTF-8"?>
<request method="handbook.getRecordMulti">
  <account></account>
  <sid></sid>
  <handbook>
    <id></id>
  </handbook>
  <records>
    <key></key>
    <key></key>
    <!-- -->
  </records>
  <signature></signature>
</request>
Название Тип Значение Примечание
sid string(32) ключ сесии выдается в результате прохождения аутентификации
handbook.id int идентификатор справочника
records.key int идентификаторы записей

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

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <records>
    <record>
      <parentKey></parentKey>
      <isGroup></isGroup>
      <key></key>
      <name></name>
      <archived></archived>
      <customData>
        <customValue>
          <field>
            <id></id>
          </field>
          <value></value>
          <text></text>
        </customValue>
        <!-- -->
      </customData>
    </record>
    <!--    -->
  </records>
</response>
Название Тип Значение Примечание
parentKey int идентификатор группы записей
isGroup bool является ли запись группой
key int идентификатор записи
name string название, если запись является группой
archived bool является ли запись архивной
customData данные записи
customData.customValue.field.id идентификатор поля
customData.customValue.value значение поля
customData.customValue.text текстовое значение поля

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

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


Перейти