Удаление сделок

Читать 3

Запрос

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
            }
        ]
    }
}
Если API-токен не указан, то удаление не выполняется и выводится ошибка: 

{
    "meta": [],
    "data": {
        "message": "Ошибка доступа"
    }
}

Если API-токен указан не верно, то удаление не выполняется и выводится ошибка: 

{

 "meta": [],

 "data": {

 "message": "Ошибка доступа"

 }

}

Параметры ответа

Параметр Формат Описание
data.orders.orderNumber string Переданный ID сделки из внешний CRM в запросе на обновление.
data.orders.updateStatus string

Статус обновления. Возможные значения:

  • success
  • error
data.orders.error object Отображется причина ошибки удаления

 

Если в запросе обнаруживаются ошибки валидации, то обновление не выполняется и выводится ошибка: 

{
    "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-запросы завершатся с ошибкой.

Не нашли решение проблемы?
Заполните форму, и мы вам поможем.
х
Заполните форму
и мы поможем вам
Похожие статьи
Недавно просмoтренные