ПланФикс API contact.get — различия между версиями

Материал из ПланФикс
Перейти к: навигация, поиск
 
(не показано 5 промежуточных версий этого же участника)
Строка 17: Строка 17:
 
     <general></general>
 
     <general></general>
 
   </contact>
 
   </contact>
 +
  <fields>
 +
    <field>lastUpdateDate</field>
 +
    ...
 +
  </fields>
 
   <signature></signature>
 
   <signature></signature>
 
</request>
 
</request>
Строка 28: Строка 32:
 
|-
 
|-
 
|userid||int ||идентификатор контакта для случаев, когда он используется в системе наравне с сотрудниками (исполнитель задачи и т.п., а также пользовательское поле типа контакт) || если задан, используется вместо id при отсутствии general
 
|userid||int ||идентификатор контакта для случаев, когда он используется в системе наравне с сотрудниками (исполнитель задачи и т.п., а также пользовательское поле типа контакт) || если задан, используется вместо id при отсутствии general
 +
|-
 +
|fields|| ||получить дополнительные поля ||
 +
|-
 +
|fields.field|| string ||поле, возможные значения:
 +
*'''lastUpdateDate''' - дата последнего изменения
 +
*'''lastCommentDate''' - дата последнего комментария
 +
|| одноименное поле будет добавлено в ответ в узел contact
 
|-
 
|-
 
|signature ||string(32) ||подпись ||
 
|signature ||string(32) ||подпись ||
Строка 51: Строка 62:
 
     <post></post>
 
     <post></post>
 
     <email></email>
 
     <email></email>
 +
    <secondaryEmails>
 +
        <email></email>
 +
        <!-- ... -->
 +
    </secondaryEmails>
 
     <phones>
 
     <phones>
 
         <phone>
 
         <phone>
Строка 83: Строка 98:
 
     </contractors>
 
     </contractors>
 
     <havePlanfixAccess>{true|false}</havePlanfixAccess>
 
     <havePlanfixAccess>{true|false}</havePlanfixAccess>
     <user>
+
     <telegram>
       <login></login>
+
       <id></id>
      <role></role>
+
     </telegram>
      <status></status>
 
      <email></email>
 
     </user>
 
 
     <customData>
 
     <customData>
 
       <customValue>
 
       <customValue>
Строка 144: Строка 156:
 
|-
 
|-
 
|email || string||адрес электронной почты ||
 
|email || string||адрес электронной почты ||
 +
|-
 +
|secondaryEmails.email || || дополнительные адреса email, если есть||
 
|-
 
|-
 
|phones|| ||список телефонов ||
 
|phones|| ||список телефонов ||
Строка 187: Строка 201:
 
|havePlanfixAccess ||bool ||имеет ли контакт доступ к ПланФикс ||данный параметр возвращается только пользователю с правами администратор
 
|havePlanfixAccess ||bool ||имеет ли контакт доступ к ПланФикс ||данный параметр возвращается только пользователю с правами администратор
 
|-
 
|-
|user || ||учетные данные контакта ||данный параметр возвращается только пользователю с правами администратор
+
|telegram.id || int || внутренний идентификатор в Telegram || возвращается только для контактов из Telegram
|-
 
|user.login ||string ||логин в системе ||
 
|-
 
|user.role ||string ||роль ||
 
|-
 
|user.status ||enum ||статус ||список допустимых значений смотри в разделе [[ПланФикс API:Статусы пользователей|статусы пользователей]]
 
|-
 
|user.email ||string ||адрес электронной почты ||
 
 
|-
 
|-
 
|customData ||  ||значения пользовательских полей задачи ||
 
|customData ||  ||значения пользовательских полей задачи ||

Текущая версия на 13:11, 20 апреля 2021

Функция получения информации о клиенте. Формат запроса:

<?xml version="1.0" encoding="UTF-8"?>
<request method="contact.get">
  <account></account>
  <sid></sid>
  <contact>
    <id></id>
    <userid></userid>
    <general></general>
  </contact>
  <fields>
    <field>lastUpdateDate</field>
    ...
  </fields>
  <signature></signature>
</request>
Название Тип Значение Примечание
contact.id int идентификатор контакта
general int номер контакта если задан, используется вместо id
userid int идентификатор контакта для случаев, когда он используется в системе наравне с сотрудниками (исполнитель задачи и т.п., а также пользовательское поле типа контакт) если задан, используется вместо id при отсутствии general
fields получить дополнительные поля
fields.field string поле, возможные значения:
  • lastUpdateDate - дата последнего изменения
  • lastCommentDate - дата последнего комментария
одноименное поле будет добавлено в ответ в узел contact
signature string(32) подпись


Результат успешного выполнения функции:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <contact>
    <id></id>
    <userid></userid>
    <general></general>
    <template>
      <id></id>
    </template>
    <name></name>
    <midName></midName>
    <lastName></lastName>
    <isCompany></isCompany>
    <post></post>
    <email></email>
    <secondaryEmails>
        <email></email>
        <!-- ... -->
    </secondaryEmails>
    <phones>
        <phone>
            <number></number>
            <typeId><typeId>
            <typeName><typeName>
        </phone>
        ...
    </phones>
    <address></address>
    <description></description>
    <sex></sex>
    <site></site>
    <skype></skype>
    <icq></icq>
    <userPic></userPic>
    <birthdate></birthdate>
    <group>
      <id></id>
      <name></name>
    </group>
    <contractors>
      <client>
        <id></id>
        <name></name>
      </client>
      <client>
        <id></id>
        <name></name>
      </client>
      <!-- ... -->
    </contractors>
    <havePlanfixAccess>{true|false}</havePlanfixAccess>
    <telegram>
      <id></id>
    </telegram>
    <customData>
      <customValue>
        <field>
          <id></id>
          <name></name>
        </field>
        <value></value>
        <text></text>
      </customValue>
      <customValue>
        <!-- ... -->
      </customValue>
      <!-- ... -->
    </customData>
    <responsible>
      <users>
        <user>
          <id></id>
          <name></name>
        </user>
        <!-- ... -->
      </users>
      <groups>
        <group>
          <id></id>
          <name></name>
        </group>
        <!-- ... -->
      </groups>
    </responsible>
  </contact>
</response>
Название Тип Значение Примечание
id int идентификатор контакта
userid int идентификатор контакта для случаев, когда он используется в системе наравне с сотрудниками (исполнитель задачи и т.п., а также пользовательское поле типа контакт)
general int номер контакта
template.id int номер шаблона контакта
name string Имя Отчество
midName string Отчество
lastName string Фамилия
isCompany boolean Является компанией
post string Должность
email string адрес электронной почты
secondaryEmails.email дополнительные адреса email, если есть
phones список телефонов
phones.phone.number string номер телефона
phones.phone.typeId int идентификатор типа номера телефона
phones.phone.typeName string название типа номера телефона
address string Адрес
description string Дополнительная информация
sex enum пол допустимые значения смотри в разделе пол клиента, если значение не установлено, то значение пусто
site string веб-сайт
skype string skype-контакт
icq string номер-icq
userPic string ссылка на изображение
birthdate DateTime дата рождения
group группа контакта
group.id int идентификатор группы
group.name string название группы
signature string(32) подпись
contractors список компаний, к которым он относится
contractors.client описание компании
contractors.client.id int идентификатор компании
contractors.client.name string имя/название компании
havePlanfixAccess bool имеет ли контакт доступ к ПланФикс данный параметр возвращается только пользователю с правами администратор
telegram.id int внутренний идентификатор в Telegram возвращается только для контактов из Telegram
customData значения пользовательских полей задачи
customData.customValue.field.id идентификатор пользовательского поля
customData.customValue.field.name название пользовательского поля
customData.customValue.value значение пользовательского поля
customData.customValue.text текстовое значение пользовательского поля
responsible корневой элемент списка ответственных
responsible.users корневой элемент списка ответственных
responsible.users.user node пользователь
responsible.users.user.id int идентификатор пользователя
responsible.users.user.name string имя пользователя
responsible.groups корневой элемент списка групп ответственных
responsible.groups.group node группа
responsible.groups.group.id int идентификатор группы
responsible.groups.group.name string название группы


В противном случае будет возвращен ответ с ошибкой:

<?xml version="1.0" encoding="UTF-8"?>
<response status="error">
  <code></code>
</response>


Перейти