Planfix API handbook.getRecord: Difference between revisions
From Planfix
(Created page with "Получение записи справочника. Формат запроса: <source lang="xml"> <?xml version="1.0" encoding="UTF-8"?> <request method="handbook.getRecord"> <account></account> <sid></sid> <handbook> <id></id> </handbook> <key></key> <signature></signature> </request> </source> {| class="wikitable" style="margin-top: 1em; width:100% " !width="150"|Name !!width="200"| Type !!width="50%"| Value !! Note |- |sid || string(32) ||клю...") |
No edit summary |
||
Line 15: | Line 15: | ||
!width="150"|Name !!width="200"| Type !!width="50%"| Value !! Note | !width="150"|Name !!width="200"| Type !!width="50%"| Value !! Note | ||
|- | |- | ||
|sid || string(32) | |sid || string(32) || issued as a result of [[Planfix API: Authentication|authentication]] completion | ||
|- | |- | ||
|handbook.id|| int || directory identifier || | |handbook.id|| int || directory identifier || |
Revision as of 13:18, 13 March 2024
Получение записи справочника. Формат запроса:
<?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) | 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>