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