• 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>