Запись опубликована:08.10.2022
Post category:Контакты
Запись изменена:03.11.2022

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>