Planfix API handbook.getRecordMulti
From Planfix
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>