Удаление сделок
Запрос
POST:
https://api.calltouch.ru/lead-service/v1/api/client-order/delete
HTTP-заголовки:
- Access-Token — API-ключ;
- SiteId — ID ЛК Calltouch.
Пример тела запроса
Тело запроса в формате JSON.
{
"orderNumbers": ["ID сделки внутри CRM 1", "ID сделки внутри CRM 2", "ID сделки внутри CRM N"]
}
Параметры запроса
На вход подается только список ID сделок в CRM. В одном запросе можно указать не более 100 сделок.
Ответ
Процесс удаления запускается сразу после отправки запроса, после чего сразу возвращается и ответ, пример:
Пример ответа
{
"meta": [],
"data": {
"orders": [
{
"orderNumber": "UdvPC9bBjjLnEJ9R",
"deleteStatus": "success",
"error": null
},
{
"orderNumber": "8I21YZ2W0lvemMtr",
"deleteStatus": "success",
"error": null
}
]
}
}
Параметры ответа
Параметр | Формат | Описание |
data.orders.orderNumber | string | Переданный ID сделки из внешнего CRM в запросе на обновление. |
data.orders.updateStatus | string |
Статус обновления. Возможные значения:
|
data.orders.error | object | Отображается причина ошибки удаления |
Типовые ошибки
Если API-токен не указан, то удаление не выполняется и выводится ошибка:
{
"meta": [],
"data": {
"message": "Ошибка доступа"
}
}
Если API-токен указан не верно, то удаление не выполняется и выводится ошибка:
{
"meta": [],
"data": {
"message": "Ошибка доступа"
}
}
Если в запросе обнаруживаются ошибки валидации, то обновление не выполняется и выводится ошибка:
{
"meta": [],
"data": {
"type": "validationError",
"apiErrorData": null,
"validationErrorData": {
"violations": [
{
"fieldPath": "orderNumbers[0]",
"message": "Тип значения должен быть string."
}
]
}
}
}
Система баллов API Calltouch
Система баллов API - механизм, регулирующий нагрузку на сервера Calltouch. Для каждого проекта выдается индивидуальное суточное количество баллов. За каждый успешно выполненный запрос списываются баллы. Подробнее читайте в статье: Система баллов API Calltouch.
Количество запросов в секунду к API Calltouch ограничено – не более 5 запросов в секунду с одного IP-адреса. Например, если в 1 секунду с одного IP-адреса поступит 11 API-запросов, то 5 выполнятся сразу, а остальные API-запросы завершатся с ошибкой c кодом 429 (Too Many Requests).
- A/B тестирование (раздел «Подключение»)
- Email-трекинг (раздел «Подключение»)
- Отслеживание офлайн конверсии (раздел «Подключение»)
- Подключение к отслеживанию дополнительных доменов (раздел «Подключение»)
- Подмена номеров на AMP-страницах Google (раздел «Подключение»)