Сегменты

Получить все

Метод

GET https://pushda.ru/api/segments/

Пример

curl --request GET \
--url 'https://pushda.ru/api/segments/' \
--header 'Authorization: Bearer {api_key}' \

Параметры	Подробности	Описание
search	Необязательный Строка	Строка поиска.
search_by	Необязательный Строка	Поле для поиска. Допустимые значения: `name`.
website_id	Необязательный Целое
datetime_field	Необязательный Строка	Допустимые значения: `datetime`, `last_datetime`
datetime_start	Необязательный Строка	Отфильтруйте результаты, начиная с этой даты-времени. Формат <код>Y-m-d H:i:s.
datetime_end	Необязательный Строка	Отфильтруйте результаты до этой даты-времени. Формат <код>Y-m-d H:i:s.
order_by	Необязательный Строка	Поле сортировки. Допустимые значения: `segment_id`, `datetime`, `last_datetime`, `name`, `total_subscribers`.
order_type	Необязательный Строка	Направление сортировки: `ASC` (по возрастанию) или `DESC` (по убыванию).
page	Необязательный Целое	Номер страницы результатов. По умолчанию `1`.
results_per_page	Необязательный Целое	Результатов на странице. Допустимые значения: `10`, `25`, `50`, `100`, `250`, `500`, `1000`. По умолчанию `25`.

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

{
    "data": [
        {
            "id": 1,
            "user_id": 1,
            "website_id": 1,
            "name": "Example",
            "settings": {
                "subscribers_ids": [1,2,3,4,5]
            },
            "type": "custom",
            "total_subscribers": 5,
            "last_datetime": null,
            "datetime": "2026-06-25 15:31:29",
        }
    ],
    "meta": {
        "page": 1,
        "results_per_page": 25,
        "total": 1,
        "total_pages": 1
    },
    "links": {
        "first": "https://pushda.ru/api/segments?page=1",
        "last": "https://pushda.ru/api/segments?page=1",
        "next": null,
        "prev": null,
        "self": "https://pushda.ru/api/segments?page=1"
    }
}

Получить один

Метод

GET https://pushda.ru/api/segments/{segment_id}

Пример

curl --request GET \
--url 'https://pushda.ru/api/segments/{segment_id}' \
--header 'Authorization: Bearer {api_key}' \

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

{
    "data": {
        "id": 1,
        "user_id": 1,
        "website_id": 1,
        "name": "Example",
        "settings": {
            "subscribers_ids": [1,2,3,4,5]
        },
        "type": "filter",
        "total_subscribers": 5,
        "last_datetime": null,
        "datetime": "2026-06-25 15:31:29",
    }
}

Параметры	Подробности	Описание
website_id	Обязательный Целое	-
name	Обязательный Строка	-
type	Необязательный Строка	Допустимые значения: `custom`, `filter`
subscribers_ids	Необязательный Строка	Доступно при: segment = custom
filters_custom_parameter_key[index]	Необязательный Строка	Доступно при: segment = filter
filters_custom_parameter_condition[index]	Необязательный Строка	Допустимые значения: `exact`, `not_exact`, `contains`, `not_contains`, `starts_with`, `not_starts_with`, `ends_with`, `not_ends_with`, `bigger_than`, `lower_than Доступно при: segment = filter`
filters_custom_parameter_value[index]	Необязательный Строка	Доступно при: segment = filter
filters_datetime_condition	Необязательный Строка	Доступно при: segment = filter `within_last`, `older_than`
filters_datetime_value	Необязательный Целое	Доступно при: segment = filter дней
filters_last_datetime_condition	Необязательный Строка	Доступно при: segment = filter `within_last`, `older_than`
filters_last_datetime_value	Необязательный Целое	Доступно при: segment = filter дней
filters_last_seen_online_datetime_condition	Необязательный Строка	Доступно при: segment = filter `within_last`, `older_than`
filters_last_seen_online_datetime_value	Необязательный Целое	Доступно при: segment = filter дней
filters_last_sent_datetime_condition	Необязательный Строка	Доступно при: segment = filter `within_last`, `older_than`
filters_last_sent_datetime_value	Необязательный Целое	Доступно при: segment = filter дней
filters_subscribed_on_url	Необязательный Строка	Доступно при: segment = filter
filters_cities	Необязательный Строка	Доступно при: segment = filter
filters_countries[]	Необязательный Строка	Доступно при: segment = filter
filters_continents[]	Необязательный Строка	Доступно при: segment = filter
filters_device_type[]	Необязательный Строка	Доступно при: segment = filter
filters_languages[]	Необязательный Строка	Доступно при: segment = filter
filters_operating_systems[]	Необязательный Строка	Доступно при: segment = filter
filters_browsers[]	Необязательный Строка	Доступно при: segment = filter

curl --request POST \
--url 'https://pushda.ru/api/segments' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'name=Example name' \
--form 'website_id=1' \
--form 'type=custom' \
--form 'subscribers_ids=1,2,3,4,5' \

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

{
    "data": {
        "id": 1
    }
}

Обновить

Метод

POST https://pushda.ru/api/segments/{segment_id}

Параметры	Подробности	Описание
website_id	Необязательный Целое	-
name	Необязательный Строка	-
type	Необязательный Строка	Допустимые значения: `custom`, `filter`
subscribers_ids	Необязательный Строка	Доступно при: segment = custom
filters_custom_parameter_key[index]	Необязательный Строка	Доступно при: segment = filter
filters_custom_parameter_condition[index]	Необязательный Строка	Допустимые значения: `exact`, `not_exact`, `contains`, `not_contains`, `starts_with`, `not_starts_with`, `ends_with`, `not_ends_with`, `bigger_than`, `lower_than Доступно при: segment = filter`
filters_custom_parameter_value[index]	Необязательный Строка	Доступно при: segment = filter
filters_datetime_condition	Необязательный Строка	Доступно при: segment = filter `within_last`, `older_than`
filters_datetime_value	Необязательный Целое	Доступно при: segment = filter дней
filters_last_datetime_condition	Необязательный Строка	Доступно при: segment = filter `within_last`, `older_than`
filters_last_datetime_value	Необязательный Целое	Доступно при: segment = filter дней
filters_last_seen_online_datetime_condition	Необязательный Строка	Доступно при: segment = filter `within_last`, `older_than`
filters_last_seen_online_datetime_value	Необязательный Целое	Доступно при: segment = filter дней
filters_last_sent_datetime_condition	Необязательный Строка	Доступно при: segment = filter `within_last`, `older_than`
filters_last_sent_datetime_value	Необязательный Целое	Доступно при: segment = filter дней
filters_subscribed_on_url	Необязательный Строка	Доступно при: segment = filter
filters_cities	Необязательный Строка	Доступно при: segment = filter
filters_countries[]	Необязательный Строка	Доступно при: segment = filter
filters_continents[]	Необязательный Строка	Доступно при: segment = filter
filters_device_type[]	Необязательный Строка	Доступно при: segment = filter
filters_languages[]	Необязательный Строка	Доступно при: segment = filter
filters_operating_systems[]	Необязательный Строка	Доступно при: segment = filter
filters_browsers[]	Необязательный Строка	Доступно при: segment = filter

Пример

curl --request POST \
--url 'https://pushda.ru/api/segments/{segment_id}' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'name=Example name' \
--form 'website_id=1' \
--form 'type=custom' \
--form 'subscribers_ids=1,2,3,4,5' \

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

{
    "data": {
        "id": 1
    }
}

Удалить

Метод

DELETE https://pushda.ru/api/segments/{segment_id}

Пример

curl --request DELETE \
--url 'https://pushda.ru/api/segments/{segment_id}' \
--header 'Authorization: Bearer {api_key}' \

Получить все

Получить один

Создать

Обновить

Удалить