Planfix API handbook.getRecord: Difference between revisions

From Planfix
Jump to: navigation, search
No edit summary
No edit summary
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
Получение записи справочника. Формат запроса:
Getting a directory entry. Request format:
<source lang="xml">
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<?xml version="1.0" encoding="UTF-8"?>
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) || issued as a result of [[Planfix API: Authentication|authentication]] completion
|sid || string(32) || session key || issued as a result of [[Planfix API: Authentication|authentication]] completion
|-
|-
|handbook.id|| int || directory identifier ||
|handbook.id|| int || directory identifier ||

Latest revision as of 13:20, 13 March 2024

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>


Go To