Planfix API handbook.getRecord
From Planfix
Getting a directory entry. Request format:
<?xml version="1.0" encoding="UTF-8"?>
<request method="handbook.getRecord">
<account></account>
<sid></sid>
<handbook>
<id></id>
</handbook>
<key></key>
<signature></signature>
</request>
Name | Type | Value | Note |
---|---|---|---|
sid | string(32) | session key | issued as a result of authentication completion |
handbook.id | int | directory identifier | |
key | int | entry identifier |
Response when the request is successfully executed:
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
<record>
<parentKey></parentKey>
<isGroup></isGroup>
<key></key>
<name></name>
<archived></archived>
<customData>
<customValue>
<field>
<id></id>
</field>
<value></value>
<text></text>
</customValue>
<!-- -->
</customData>
</record>
</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>