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