ПланФикс API contact.get: различия между версиями
Материал из Planfix
Seva (обсуждение | вклад) Нет описания правки |
Seva (обсуждение | вклад) Нет описания правки |
||
Строка 39: | Строка 39: | ||
<skype></skype> | <skype></skype> | ||
<icq></icq> | <icq></icq> | ||
< | <userPic></userPic> | ||
<birthdate></birthdate> | <birthdate></birthdate> | ||
<contractors> | <contractors> | ||
Строка 91: | Строка 91: | ||
|icq ||string ||номер-icq || | |icq ||string ||номер-icq || | ||
|- | |- | ||
| | |userPic || string||ссылка на изображение || | ||
|- | |- | ||
|birthdate || DateTime||дата рождения || | |birthdate || DateTime||дата рождения || |
Версия от 15:42, 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>
<userPic></userPic>
<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 | Должность | |
string | адрес электронной почты | ||
mobilePhone | string | Мобильный телефон | |
workPhone | string | Рабочий телефон | |
homePhone | string | Домашний телефон | |
address | string | Адрес | |
description | string | Дополнительная информация | |
sex | enum | пол | допустимые значения смотри в разделе пол клиента, если значение не установлено, то значение пусто |
skype | string | skype-контакт | |
icq | string | номер-icq | |
userPic | 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>