Запрос

PUT /contact/[contact_id]

Передаваемые данные

  • contact_id - ID контакта (вернее, person_id)

Тело запроса

{
  "name": "Contact_Name",
  "profession": "Profession",
  "site": "personal_site.com",
  "clear_contacts": false,
  "details": [
    {
      "type": "email",
      "data": "email@example.com/+71234567890"
    }
  ],
  "field" : {
    "12": "newText"
  }
}

Важные уточнения

  • Параметр type в массиве contacts может принимать значения: 'email', 'phone', 'skype', 'icq', 'facebook', 'vk'
  • Ни один из параметров в теле запроса не является обязательным
  • В теле запроса должен быть хотя бы один параметр
  • При передаче пустого параметра значение стирается
  • Если параметр не передан, значение остается неизмененным
  • Массив контактных данных будет добавлен к уже имеющимся данным
  • При передаче параметра clear_contacts с значением true, вся информация у контакта будет стерта и записана лишь та, которая была передана в теле запроса
  • При передаче параметра clear_contacts с значением false будет изменена только передаваемая информация, остальная - останется без изменений.

Пример запроса

curl -H 'Content-Type: application/json' \
    -H 'token: someToken' \
    -X PUT \
    -d '{"name": "Алексей", "profession": "Архитектор", "details": [{"type":"email", "data":"email@example.com" }], "fields": {"12": "newText"} }' \
    https://direct.lptracker.ru/contact/12345

Пример ответа при успешном выполнении:

{
  "status": "success",
  "result": {
    "id": "contact_id",
    "project_id": 123,
    "details": [
      {
        "id": "contact_detail_id",
        "type": "email/phone",
        "data": "email@example.com/+71234567890"
      }
    ],
    "fields": [
      {
        "id": "12",
        "type": "string",
        "name": "fieldName",
        "value": "exampleText"
      }
    ],
    "created_at": "DD.MM.YY HH:MM:SS",
    "name": "user_name",
    "site": "example.com"
  }
}

Описание модели контакта