Planfix API handbook.getRecord: Difference between revisions

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
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

@@ Line 1: / Line 1: @@
-Получение записи справочника. Формат запроса:
+Getting a directory entry. Request format:
 <source lang="xml">
 <?xml version="1.0" encoding="UTF-8"?>
@@ Line 15: / Line 15: @@
 !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) || session key || issued as a result of [[Planfix API: Authentication|authentication]] completion
 |-
 |handbook.id|| int || directory identifier ||