Planfix API handbook.getRecordMulti

From Planfix
Jump to: navigation, search

A function for obtaining multiple directory entries by their identifiers. It allows you to get data for up to 100 entries per request. Request format:

<?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>
Name Type Value Note
sid string(32) session key issued as a result of authentication completion
handbook.id int directory identifier
records.key int entry identifiers

Response when the request is successfully executed:

<?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>
Name Type Value Note
parentKey int entry group identifier
isGroup bool is the entry a group
key int entry identifier
name string name, if the entry is a group
archived bool is the entry archived
customData entry data
customData.customValue.field.id field identifier
customData.customValue.value field value
customData.customValue.text text value of the field

Otherwise, a response with an error will be returned:

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


Go To