PUT api/2.0/crm/contact/person/{personid}
Для этой функции требуется аутентификация.
Описание
Обновляет выбранного пользователя с параметрами (имя. фамилия, описание, т.д.) указанными в запросе.
Параметры
Название | Описание | Тип | Пример |
personid sent in url | Идентификатор пользователя | номер | 1234 |
firstName sent in body | Новое имя | строковый | текст |
lastName sent in body | Новая фамилия | строковый | текст |
jobTitle sent in body | Новое название работы необязательно | строковый | текст |
companyId sent in body | Новый идентификатор компании необязательно | номер | 1234 |
about sent in body | Новое описание пользователя необязательно | строковый | текст |
shareType sent in body | Конфиденциальность нового пользователя: 0 — не предоставлен доступ, 1 — предоставлен доступ для чтения/записи, 2 — предоставлен доступ только для чтения | None, ReadWrite, Read | |
managerList sent in body | Новый список менеджеров по персоналу необязательно | Collection of guids collection? | 9924256A-739C-462b-AF15-E652A3B1B6EB |
customFieldList sent in body | Новый список пользовательских полей необязательно | Collection of ASC.Api.Collections.ItemKeyValuePair`2[System.Int32,System.String]s collection | |
photo sent in body | Новое фото контакта (загрузить с помощью multipart/form-data) необязательно | Files for adding using multipart/form-data collection ? | N/A |
Пример
PUT api/2.0/crm/contact/person/1234
Host: yourportal.r7-office.ru
Content-Type: application/json
Accept: application/json
{
"firstName": "some text",
"lastName": "some text",
"jobTitle": "some text",
"companyId": 1234,
"about": "some text",
"shareType": "none",
"managerList": [
"00000000-0000-0000-0000-000000000000"
],
"customFieldList": [
{
"Key": 0,
"Value": null
}
],
"photo": []
}
Возвращает
Пользователь
Пример ответа
application/json
{
"status": 0,
"response": {
"firstName": "Tadjeddine",
"lastName": "Bachir",
"company": {
"companyName": "Food and Culture Project",
"about": "",
"haveLateTasks": false,
"displayName": null,
"isCompany": true,
"isPrivate": true,
"isShared": false,
"shareType": 0,
"currency": null,
"canEdit": false,
"canDelete": false,
"id": 0
},
"title": "Programmer",
"createBy": {
"id": "00000000-0000-0000-0000-000000000000",
"displayName": "Mike Zanyatski",
"title": "Manager",
"avatarSmall": "url to small avatar",
"profileUrl": ""
},
"created": "2022-10-07T10:03:01.5035397Z",
"about": "",
"haveLateTasks": false,
"displayName": null,
"isCompany": false,
"isPrivate": true,
"isShared": false,
"shareType": 0,
"currency": null,
"canEdit": false,
"canDelete": false,
"id": 0
}
}
text/xml
<result>
<status>0</status>
<response>
<firstName>Tadjeddine</firstName>
<lastName>Bachir</lastName>
<company>
<companyName>Food and Culture Project</companyName>
<about></about>
<haveLateTasks>false</haveLateTasks>
<displayName />
<isCompany>true</isCompany>
<isPrivate>true</isPrivate>
<isShared>false</isShared>
<shareType>0</shareType>
<currency />
<canEdit>false</canEdit>
<canDelete>false</canDelete>
<id>0</id>
</company>
<title>Programmer</title>
<createBy>
<id>00000000-0000-0000-0000-000000000000</id>
<displayName>Mike Zanyatski</displayName>
<title>Manager</title>
<avatarSmall>url to small avatar</avatarSmall>
<profileUrl></profileUrl>
</createBy>
<created>2022-10-07T10:03:01.5035397Z</created>
<about></about>
<haveLateTasks>false</haveLateTasks>
<displayName />
<isCompany>false</isCompany>
<isPrivate>true</isPrivate>
<isShared>false</isShared>
<shareType>0</shareType>
<currency />
<canEdit>false</canEdit>
<canDelete>false</canDelete>
<id>0</id>
</response>
</result>