Planfix API handbook.getRecord: Difference between revisions

From Planfix
Jump to: navigation, search
(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) ||ключ сесии || session key || issued as a result of [[Planfix API: Authentication|authentication]] completion
|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>


Go To