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

Материал из ПланФикс
Версия от 10:15, 4 апреля 2018; Seva (обсуждение | вклад) (Новая страница: «Запрос на получение списка справочников имеет следующий вид: <source lang="xml"> <?xml version="1.0" encoding=…»)
(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)
Перейти к: навигация, поиск

Запрос на получение списка справочников имеет следующий вид:

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

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

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
    <handbooks count="count" totalCount="totalCount">
        <handbook>
            <id></id>
            <name></name>
            <group>
                <id></id>
                <name></name>
            </group>
        </handbook>
        <handbook>
            <id></id>
            <name></name>
            <group>
                <id></id>
                <name></name>
            </group>
        </handbook>
        <!-- ... -->
    </handbooks>
</response>
Название Тип Значение Примечание
handbooks int список справочников
handbooks count int количество справочников в списке
handbooks totalCount int количество справочников в списке
handbook справочник
handbook.id int идентификатор справочника
handbook.name string название справочника
handbook.group группа
handbook.group.id int идентификатор группы
handbook.group.name string название группы

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

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


Перейти