POST /client/store-or-first — Найти или создать клиента

Данный метод находит клиента по номеру телефона или создает нового, если он не был найден. Возвращает данные клиента в обоих случаях.

При выполнении запроса Access Token необходимо поместить в заголовки (ключ Authorization с указанием типа Bearer), а в теле запроса указать все необходимые параметры метода. При этом не забудьте, что сервер ожидает перечисление параметров в формате JSON, кодировке UTF-8.

Параметры запроса:

Пример запроса с перечислением параметров:

curl -X POST "https://{idcrm}-crm-api.vionvi.com/client/store-or-first" \
     -H "Authorization: Bearer ezI1NiJ9.eyJhdWQiOiIyIiwianRpIjoiNGNhMTgwMDczM2" \
     -H "Content-Type: application/json" \
     -d '{
       "surname": "Иванов",
       "firstName": "Иван",
       "patronymic": "Петрович",
       "phone": 79991234567,
       "email": "email@example.com"
     }'

Мы используем обычные коды ответов HTTP для обозначения результата выполнения запроса. Ответ от сервера приходит в формате JSON и кодировке UTF-8. При успешном ответе возвращаемый сервером результат будет представлен в теле ответа массивом data. При ошибке выполнения запроса вы можете получить в теле ответа массив errors.

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

201 Created
{
  "data": {
    "id": 50,
    "surname": "Иванов",
    "firstName": "Иван",
    "patronymic": "Петрович",
    "phone": 79991234567,
    "email": "email@example.com"
  }
}

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

422 Unprocessable Content
{
  "errors": {
      "firstName": [
          "Имя обязательно для заполнения."
      ]
  }
}