Список IP-адресов

Интерфейсы управления рекламой

Интерфейс используется для получения списка IP-адресов посетителей сайтов. Список доступен только при включении уникальности IP-адресов в настройках сайтов.

Для использования этого интерфейса вам необходимо создать запрос по адресу обработчика и передать параметры операции. Помимо обязательных параметров, нужно передать следующие параметры:

Action: http://go.jetswap.com/api
Method: POST
PAY_ACTION: statip
Поля, передаваемые в форме:

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

idst Да ID сайтов, для которых требуется выполнить команду. Содержит ID сайтов, разделенные двоеточием, например 123:234:456.
extended Нет Тип формата вывода
0 - обычный (по умолчанию)

1 - расширенный

Ответ: передается в формате URL Encoded массив, содержащем результаты выполнения операции для каждого переданного в idst сайта (см. пример ответа).

Параметр
Описание

notexists Выдается значение 1 при отсутствии доступа к сайту с заданным ID или если сайт с таким ID не существует.
Массив IP Для каждого ID сайта выдается массив IP-адресов посетителей сайта.

Пример: сервером может быть выдан например ответ !647730[0]=178.49.10.197&647730[1]=80.80.117.185&647730[2]=95.182.32.24&647730[3]=95.190.28.178.
После устранения ! перед ответом и обработки текста ответа функцией php parse_str выходной массив примет вид: Для обычного вывода:

Array
(
    [647730] => Array ID сайта
        (
            [0] => 178.49.10.197 IP-адреса
            [1] => 80.80.117.185
            [2] => 95.182.32.24
            [3] => 95.190.28.178
        )
)

Для расширенного вывода:

Array(
    [5453871] => Array ID сайта
        (
            [0] => Array Номер записи по порядку
                (
                    [ip] => 780402806 IP-адрес, преобразуется в строчный формат функцией long2ip
                    [ts] => 1723283263 Unix-Timestamp времени посещения
                    [country] => 2291 ID страны посетителя
                    [region] => 2292 ID региона посетителя
                    [city] => 2293 ID города посетителя
                    [time] => 30 Продолжительность посещения в секундах
                )
        )
)

ID объектов геотаргетинга можно узнать здесь
Массив IP-адресов выдается отдельно для каждого ID сайта, переданного в параметре idst.

Готовая функция для этого интерфейса на языке PHP доступна в списке API-интерфейсов при нажатии на значок "Пример PHP-кода"