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

Версия от 14:17, 8 декабря 2010

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

<?xml version="1.0" encoding="UTF-8"?>
<request method="contact.update">
  <account></account>
  <sid></sid>
  <contact>
    <id></id>
  </contact>
  <signature></signature>
</request>

Название	Тип	Значение	Примечание
contact.id	int	идентификатор контакта
signature	string(32)	подпись

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

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <contact>
    <id></id>
    <name></name>
    <lastName></lastName>
    <post></post>
    <email></email>
    <mobilePhone></mobilePhone>
    <workPhone></workPhone>
    <homePhone></homePhone>
    <address></address>
    <description></description>
    <sex></sex>
    <skype></skype>
    <icq></icq>
    <userPicUrl></userPicUrl>
    <birthdate></birthdate>
    <contractors>
      <client>
        <id></id>
        <name></name>
      </client>
      <client>
        <id></id>
        <name></name>
      </client>
      <!-- ... -->
    </contractors>
    <havePlanfixAccess>{true|false}</havePlanfixAccess>
    <user>
      <login></login>
      <role></role>
      <status></status>
      <email></email>
    </user>
  </contact>
</response>

Название	Тип	Значение	Примечание
id	int	идентификатор контакта
name	string	Имя Отчество
lastName	string	Фамилия
post	string	Должность
email	string	адрес электронной почты
mobilePhone	string	Мобильный телефон
workPhone	string	Рабочий телефон
homePhone	string	Домашний телефон
address	string	Адрес
description	string	Дополнительная информация
sex	enum	пол	допустимые значения смотри в разделе пол клиента, если значение не установлено, то значение пусто
skype	string	skype-контакт
icq	string	номер-icq
userPicUrl	string	ссылка на изображение
birthdate	DateTime	дата рождения
signature	string(32)	подпись
contractors		список контрагентов, к которым он относится
contractors.client		описание контрагента
contractors.client.id	int	идентификатор клиента/контрагента
contractors.client.name	string	имя/название контрагента
havePlanfixAccess	bool	имеет ли контакт доступ к ПланФикс	данный параметр возвращается только пользователю с правами администратор
user		учетные данные контакта	данный параметр возвращается только пользователю с правами администратор
user.login	string	логин в системе
user.role	string	роль
user.status	enum	статус	список допустимых значений смотри в разделе статусы пользователей
user.email	string	адрес электронной почты

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

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

Перейти

@@ Строка 40: / Строка 40: @@
      <icq></icq>
      <userPicUrl></userPicUrl>
-     <birthday></birthday>
+     <birthdate></birthdate>
      <contractors>
        <client>
@@ Строка 93: / Строка 93: @@
 |userPicUrl || string||ссылка на изображение ||
 |-
-|birthday || DateTime||дата рождения ||
+|birthdate || DateTime||дата рождения ||
 |-
 |signature || string(32)||подпись ||
@@ Строка 113: / Строка 113: @@
 |user.role ||string ||роль ||
 |-
-|user.status ||enum ||статус ||
+|user.status ||enum ||статус ||список допустимых значений смотри в разделе [[ПланФикс API:Статусы пользователей|статусы пользователей]]
 |-
 |user.email ||string ||адрес электронной почты ||