/ Опубликовано в Roistat

API – События

Время на прочтение: 2 минут(ы)

Добавить событие в архив¶

POST /project/events/meta/{i:eventId}/archive

C помощью этого метода можно добавить событие в архив.

curl 'https://cloud.roistat.com/api/v1/project/events/meta/{i:eventId}/archive?project=12345' 
    --request POST 
    --header 'Content-type: application/json'  
    --header 'Api-key: {KEY}'  
    --data Тело запроса - см. ниже

Тело запроса:

[
    {
        "display_name": "test1",
        "type": "js",
        "parameter": "js-12"
    },
    {
        "display_name": "test2",
        "type": "url",
        "parameter": "http://test.com"
    }
]

Без параметров.

Строка запроса:

Параметр Тип Описание Обязательный
project string Номер проекта да

Тело запроса:

Параметр Тип Описание Обязательный
display_name string нет
type string нет
parameter string нет

Параметр Тип Описание
type string
properties object
> events object
>> type string
>> items object
>>> type string
>>> properties object
>>>> id object
>>>>> type string
>>>> display_name object
>>>>> type string
>>>> type object
>>>>> type string
>>>> parameter object
>>>>> type string
> status object
>> type string

Создать события¶

POST /project/events/add

С помощью данного метода можно добавить события списком.

curl 'https://cloud.roistat.com/api/v1/project/events/add?project=12345' 
    --request POST 
    --header 'Content-type: application/json'  
    --header 'Api-key: {KEY}'  
    --data Тело запроса - см. ниже

Тело запроса:

[
    {
        "display_name": "test1",
        "type": "js",
        "parameter": "js-12"
    },
    {
        "display_name": "test2",
        "type": "url",
        "parameter": "http://test.com"
    }
]


{
    "events": [
        {
            "id": "13",
            "display_name": "test1",
            "type": "js",
            "parameter": "js-12"
        },
        {
            "id": "14",
            "display_name": "test2",
            "type": "url",
            "parameter": "http://test.com"
        }
    ],
    "status": "success"
}

Строка запроса:

Параметр Тип Описание Обязательный
project string Номер проекта да

Тело запроса:

Параметр Тип Описание Обязательный
display_name string название события нет
type string js или url — определяет условие срабатывания события нет
parameter string ID события или ссылка нет

Параметр Тип Описание
events array[object]
> id string
> display_name string
> type string
> parameter string
status string

Получить данные по каждому событию из истории срабатываний¶

GET /project/events/log

С помощью этого метода можно получить данные по каждому событию из истории срабатываний.

curl 'https://cloud.roistat.com/api/v1/project/events/log?project=12345' 
    --request GET 
    --header 'Content-type: application/json'  
    --header 'Api-key: {KEY}'  
    --data Тело запроса - см. ниже

Тело запроса:

Без параметров.

Строка запроса:

Параметр Тип Описание Обязательный
project string Номер проекта да

Тело запроса:

Параметр Тип Описание Обязательный
name string нет

Параметр Тип Описание
items array[object]
> id string ID срабатывания события
> display_name string Название события
> parameter string URL или ID события
> type string Условие срабатывания
> event_date string Дата срабатывания
> data null или object Дополнительные данные о срабатывании события
> visit_id null или string
status string

Отправить событие¶

POST /project/events/send

С помощью данного метода можно отправлять события.

curl 'https://cloud.roistat.com/api/v1/project/events/send?project=12345' 
    --request POST 
    --header 'Content-type: application/json'  
    --header 'Api-key: {KEY}'  
    --data Тело запроса - см. ниже

Тело запроса:

{
    "name": "Открытие формы",
    "visit": "100001",
    "data": {
        "region": "Москва",
        "landing": 1
    }
}

Строка запроса:

Параметр Тип Описание Обязательный
project string Номер проекта да

Тело запроса:

Параметр Тип Описание Обязательный
name string Название события, созданного в Roistat да
visit string Номер визита из куки roistat_visit нет
data object Дополнительные параметры события (отображаются в Истории срабатываний в столбце «Доп.поля») нет

Параметр Тип Описание
status string

Отправить сразу несколько событий¶

POST /project/events/bulk/send

Метод позволяет отправлять сразу несколько событий.

curl 'https://cloud.roistat.com/api/v1/project/events/bulk/send?project=12345' 
    --request POST 
    --header 'Content-type: application/json'  
    --header 'Api-key: {KEY}'  
    --data Тело запроса - см. ниже

Тело запроса:

[
    {
        "name": "Открытие формы",
        "visit": "100001",
        "data": {
            "region": "Москва",
            "landing": 1
        }
    },
    {
        "name": "Открытие формы",
        "visit": "100002",
        "data": {
            "region": "Москва",
            "landing": 1
        }
    }
]

Строка запроса:

Параметр Тип Описание Обязательный
project string Номер проекта да

Тело запроса:

Параметр Тип Описание Обязательный
name string Название события, созданного в Roistat нет
visit string Номер визита из куки roistat_visit нет
data object Дополнительные параметры события (отображаются в Истории срабатываний в столбце «Доп.поля») нет

Параметр Тип Описание
status string

Что вы можете прочитать дальше

Подключение номеров Битрикс24 к Коллтрекингу Roistat
Виджет для воспроизведения звонков в CRM
Подключение номеров AltegroFON к Коллтрекингу Roistat