Создать контакт

POST /users/{userID}/contacts

Обновлено больше недели назад

Запросом создается контакт в Адресную книгу организации.
В заголовке запроса передается USERID сотрудника, в адресную книгу которого нужно добавить этот контакт.

МЕТОД HTTP

POST 

URL

ОБЯЗАТЕЛЬНЫЕ ПАРАМЕТРЫ

  • email — электронная почта контакта.  Уникальный идентификатор контакта. Невозможно создать двух людей с одной почтой. При попытке создания контакта с уже существующим email в ответе на запрос будет ошибка — 409.

ДОПОЛНИТЕЛЬНЫЕ ПАРАМЕТРЫ

  • name — имя;

  • secondName — фамилия;

  • company — организация, в которой работает пользователь;

  • position — должность;

  • phoneMain — телефон;

  • tags[] — личные теги контакта. Передается как массив тегов, которые будут прикреплены к контакту при создании;

  • publicTags[] — публичные теги контакта, которые будут доступны всем сотрудникам Организации. Передается аналогично, как массив тегов;

  • photo — фото участника. Можно передать либо ссылку на картинку, либо fileID картинки из файлового менеджера Организации.

ПОЛЯ ОТВЕТА

  • id — contactID созданного контакта;

  • avatar — ссылка на фото контакта;

  • thumbnails — ссылки на миниатюры фото контакта. В пользовательских сценариях не используются.

ПРИМЕР ЗАПРОСА

url: https://userapi.webinar.ru/v3/users/{userID}/contacts,
method: POST,
headers:
{
    x-auth-token: {Token},
    Content-Type: application/x-www-form-urlencoded
},
data:
{
    email: i.ivanchenko@webinar.ru,
    name: Иван,
    secondName: Иванченко,
    company: Вебинар,
    position: Менеджер по работе с клиентами,
    phoneMain: 88003505490,
    tags[0]: Сотрудник,
    photo: 1245282
};

ПРИМЕР ОТВЕТА

201 - Created            
{
  "id": 49381799,
  "avatar": {
    "url": "https://events-storage.webinar.ru/api-storage/files/webinar/2016/05/23/PXYRMihxEgEDH613IiIp6DCvIIcAGsXZcpPJr8hj9oP1Ojz4.jpg",
    "thumbnails": {
      "640x1920": "https://events-storage.webinar.ru/api-storage/640x1920/files/webinar/2016/05/23/PXYRMihxEgEDH613IiIp6DCvIIcAGsXZcpPJr8hj9oP1Ojz4.jpg",
      "1920x1080": "https://events-storage.webinar.ru/api-storage/1920x1080/files/webinar/2016/05/23/PXYRMihxEgEDH613IiIp6DCvIIcAGsXZcpPJr8hj9oP1Ojz4.jpg",
      "1333x1000": "https://events-storage.webinar.ru/api-storage/1333x1000/files/webinar/2016/05/23/PXYRMihxEgEDH613IiIp6DCvIIcAGsXZcpPJr8hj9oP1Ojz4.jpg",
      "224x199": "https://events-storage.webinar.ru/api-storage/224x199/files/webinar/2016/05/23/PXYRMihxEgEDH613IiIp6DCvIIcAGsXZcpPJr8hj9oP1Ojz4.jpg",
      "200x50": "https://events-storage.webinar.ru/api-storage/200x50/files/webinar/2016/05/23/PXYRMihxEgEDH613IiIp6DCvIIcAGsXZcpPJr8hj9oP1Ojz4.jpg",
      "50x50": "https://events-storage.webinar.ru/api-storage/50x50/files/webinar/2016/05/23/PXYRMihxEgEDH613IiIp6DCvIIcAGsXZcpPJr8hj9oP1Ojz4.jpg",
      "34x34": "https://events-storage.webinar.ru/api-storage/34x34/files/webinar/2016/05/23/PXYRMihxEgEDH613IiIp6DCvIIcAGsXZcpPJr8hj9oP1Ojz4.jpg",
      "148x112": "https://events-storage.webinar.ru/api-storage/148x112/files/webinar/2016/05/23/PXYRMihxEgEDH613IiIp6DCvIIcAGsXZcpPJr8hj9oP1Ojz4.jpg"
    }
  }
}            
Нашли ответ на свой вопрос?