• Post category:Контакты
  • Запись изменена:03.11.2022

POST api/2.0/crm/contact/person

Для этой функции требуется аутентификация. 

Описание
Создает персону с указанными в запросе параметрами (имя, фамилия, описание и т.д.).

Параметра
Название Описание
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
Список менеджеров по персоналу

необязательно
Коллекция guids

Коллекция
9924256A-739C-462b-AF15-E652A3B1B6EB
customFieldList

sent in body
Custom field list?

необязательно
Collection of ASC.Api.Collections.ItemKeyValuePair`2[System.Int32,System.String]s

collection
photo

sent in body
Фотография контакта (загрузить с использованием multipart/form-data)

необязательно
Файлы для добавления используют  multipart/form-
сбор данных
N/A
Пример
POST api/2.0/crm/contact/person
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>