Перейти к содержанию

API Cобытий

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

POST https://cloud.roistat.com/api/v1/project/events/meta/{i:eventId}/archive

Метод добавляет событие в архив.

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": "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 https://cloud.roistat.com/api/v1/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": "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 https://cloud.roistat.com/api/v1/project/events/log

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

curl 'https://cloud.roistat.com/api/v1/project/events/log?project=12345' \
--request POST \
--header 'Content-type: application/json' \
--header 'Api-key: {KEY}' \
--data '{"name": "Переход в корзину","date_from": "2022-04-04T20:59:59.999Z","date_to": "2022-05-04T15:00:00.000Z"}'

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

{
    "name": "Переход в корзину",
    "date_from": "2022-04-04T20:59:59.999Z",
    "date_to": "2022-05-04T15:00:00.000Z"
}
{
    "items": [
        {
            "id": "123",
            "display_name": "Переход в корзину",
            "parameter": "view_contacts_page",
            "type": "js",
            "event_date": "2022-04-04T23:51:58+0000",
            "data": null,
            "visit_id": "41599"
        },
        {
            "id": "456",
            "display_name": "Переход в корзину",
            "parameter": "cozy.home.ru/catalog/decor",
            "type": "url",
            "event_date": "2022-05-03T23:51:29+0000",
            "data": null,
            "visit_id": "41598"
        }
    ],
    "status": "success"
}

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

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

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

Параметр Тип Описание Обязательный
name string Название события нет
date_from string Дата, с которой учитывать срабатывания нет
date_to 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 https://cloud.roistat.com/api/v1/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, "client": {"name": "Имя клиента", "phone": "Номер телефона", "email": "[email protected]"}}}'

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

{
    "name": "Название события",
    "visit": "100001",
    "data": {"region": "Москва",
             "landing": 1,
             "client": {"name": "Имя клиента", 
                        "phone": "Номер телефона", 
                        "email": "[email protected]"}
            }
}
{
    "status": "success"
}

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

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

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

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

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

POST https://cloud.roistat.com/api/v1/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": {"client": "name": "Имя клиента", "phone": "Номер телефона", "email": "[email protected]"}}]'

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

[
    {
        "name": "Открытие формы",
        "visit": "100001",
        "data": {"region": "Москва",
                 "landing": 1}
    },
    {
        "name": "Регистрация",
        "visit": "100002",
        "data": {"client": {"name": "Имя клиента", 
                            "phone": "Номер телефона", 
                            "email": "[email protected]"}
                }
    }
]
{
    "status": "success"
}

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

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

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

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