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

Материал из ПланФикс
Перейти к: навигация, поиск
Строка 2: Строка 2:
 
<source lang="xml">
 
<source lang="xml">
 
<?xml version="1.0" encoding="UTF-8"?>
 
<?xml version="1.0" encoding="UTF-8"?>
<request method="analitic.getOptions">
+
<request method="handbook.getRecords">
 
   <account></account>
 
   <account></account>
 
   <sid></sid>
 
   <sid></sid>

Версия 10:29, 4 апреля 2018

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

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

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

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


Перейти