API для推送уведомлений

Получить список отправленных推рассылок

Чтобыполучитьсписокотправленных推动рассылок,отправьте得到запроспоссылке:

https://api.半岛客户端下载官网m.ekobsc.com/push/tasks

Параметрызапроса:

Параметр Тип Описание
限制 int Количество возвращаемых записей 可选
抵消 int Смещениевыдачи 可选
从* 字符串 Дата начала выбранного промежутка 可选
* 字符串 Дата окончания промежутка 可选
website_id int 我сайта， для которого запрашивается статистика 可选

*Указывайте даты * форматеYYYY-mm-dd H:我:s．

Ограничениенаколичествополучаемыхзаписейвответ——до100зараз。

Дляполучениясписковнеобходимоиспользоватьпараметр抵消для смещения по результатам。

ПримерURLзапроса(вывести10записей,начинаясовторой):

https://api.半岛客户端下载官网m.ekobsc.com/push/tasks/?limit=10&offset=2

В случае успешного запроса вы получите ответ:

[{" id ": 121,“标题”:“推”、“身体”:“文本”,“website_id”:53岁,“从”:“2015-11-17 14:44:47”、“到”:“2015-12-23 19:42:27”,“状态”:13}]

Получить общее количество сайтов

Чтобыпросмотретьобщееколичествосайтов,отправьте得到запроспоссылке:

https://api.半岛客户端下载官网m.ekobsc.com/push/websites/total

В случае успешного запроса вы получите ответ:

{"total": 2}

Получить список сайтов

Чтобыполучитьсписоксайтов,отправьте得到запроспоссылке:

https://api.半岛客户端下载官网m.ekobsc.com/push/websites/

Параметрызапроса:

Параметр Тип Описание
限制 int Количество записей， которое нужно взять 可选
抵消 int Смещениевыдачи 可选

Ограничениенаколичествополучаемыхзаписейвответ——до100зараз。

Дляполучениясписковнеобходимоиспользоватьпараметр抵消для смещения по результатам。

ПримерURLзапросаприпередачедополнительныхпараметров:

https://api.半岛客户端下载官网m.ekobsc.com/push/websites/?limit=10&offset=2

В случае успешного запроса вы получите ответ:

[{" id ": 53岁“url”:“www.test-site.com”,“add_date”:“2015-11-23 14:42:37”,“状态”:1}]

Получить список переменных для сайта

Чтобыполучитьсписоквсехпеременныхдляданногосайта,отправьте得到запроспоссылке:

https://api.半岛客户端下载官网m.ekobsc.com/push/websites/ {id} /变量

Параметрзапроса:

Параметр Тип Описание
id int IDсайта 要求

В случае успешного запроса вы получите ответ:

[{" id ": 97,“名字”:“uname”,“类型”:“字符串”}]

Получить список подписчиков сайта

Чтобыполучитьсписокподписчиковдляконкретногосайта,отправьте得到запроспоссылке:

https://api.半岛客户端下载官网m.ekobsc.com/push/websites/ {id} /订阅

Параметрызапроса:

Параметр Тип Описание
id int IDсайта 要求
限制 int Количество записей， которое нужно взять 可选
抵消 int Смещениевыдачи 可选
subscription_date_from 字符串 Фильтрподатедобавленияподписчиков(указываетсядатаивремясипотакойтопромежутоквремени)задаетсявформатеY-m-d(Пример:2018-03-11） 可选
subscription_date_to 字符串 Фильтрподатедобавленияподписчиков(указываетсядатаивремясипотакойтопромежутоквремени)задаетсявформатеY-m-d(Пример:2018-03-11） 可选

Ограничениенаколичествополучаемыхзаписейвответ——до100зараз。

Дляполучениясписковнеобходимоиспользоватьпараметр抵消для смещения по результатам。

ПримерURLзапросаприпередачедополнительныхпараметров:

https://api.半岛客户端下载官网m.ekobsc.com/push/websites/37731/subscriptions/?subscription_date_from%3D2018-09-04%2001%3A54%3A00%26subscription_date_to%3D2018-09-04%2017%3A00%3A00

В случае успешного запроса вы получите ответ:

[{" id ": 311003743,“浏览器”:“火狐”、“朗”:“en”,“操作系统”:“Linux”,“country_code”:“UA”、“城市”:“Dnipro”、“变量”:[],“subscription_date”:“2018-08-13 14:27:11”,“状态”:1},{" id ": 311008277,“浏览器”:“歌剧”,“朗”:“en”,“操作系统”:“Linux”,“country_code”:“UA”、“城市”:“Dnipro”、“变量”:[],“subscription_date”:“2018-08-13 14:33:51”,“状态”:1}]

Статусыподписчиков:

Статус Описание
0 停用
1 活跃的
6 没订阅

Получить количество подписчиков сайта

Чтобыполучитьобщеечислоподписчиковдлясайта,отправьте得到запроспоссылке:

https://api.半岛客户端下载官网m.ekobsc.com/push/websites/ {id} /订阅/总

Параметрызапроса:

Параметр Тип Описание
id int IDсайта 要求

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

{"total": 2}

Получить информацию по сайту

Чтобыполучитьинформациюпосайту、отправьте得到запроспоссылке:

https://api.半岛客户端下载官网m.ekobsc.com/push/websites/info/ {id}

Параметрзапроса:

Параметр Тип Описание
id int IDсайта 要求

В случае успешного запроса вы получите ответ:

{"id": 111111， "url": "yoursite.com"， "status": "active"， "icon": "https://login.s半岛客户端下载官网endpulse.com/img/my/push/push-default-icons/icon.png"， "add_date": "2017-11-09 13:08:37"， "total_subscribers": 1081， "unsubscribed": 30， "subscribers_today": 10， "active_subscribers": 1051}

Получить js код для сайта

ЧтобыполучитьJSкоддлясайта,отправьте得到запроспоссылке:

https://api.半岛客户端下载官网m.ekobsc.com/push/websites/ {id} /代码

Параметрзапроса:

Параметр Тип Описание
id int IDсайта 要求

В случае успешного запроса вы получите ответ:

{"script_url": "//web.webpushs.com/js/push/00008bf5640047e81be53f4a2891dd36e9_1.js"， "script_code": ""}

Активировать/Деактивироватьподписчика

Чтобыактивироватьилидеактивироватьподписчика,отправьтеPOSTзапроспоссылке:

https://api.半岛客户端下载官网m.ekobsc.com/push/subscriptions/state

Параметрызапроса:

Параметр Тип Описание
id int IDподписчика 要求
状态 int Тригер переключения состояния подписчика，1- - - - - -активен,0——деактивирован 要求

В случае успешного запроса вы получите ответ:

{"result": true}

Создать новую推-рассылку

Чтобысоздатьновую推——рассылку、отправьтеPOSTзапроспоссылке:

https://api.半岛客户端下载官网m.ekobsc.com/push/tasks

Ограничениепоотправке推——уведомленийдлясайта- 1рассылкав15минут。

Длятриггерныхрассылок推——уведомленийиспользуйтенашфункционалAutomation360．

Обязательные параметры запроса:

Параметр Тип Описание
标题 字符串 Заголовок 要求
website_id int IDсайта 要求
身体 字符串 Телорассылки 要求
ttl int Времяжизни推动рассылки,указываетсявсекундах。максимум - 86400 (24 часа) 要求
链接 字符串 Ссылкадляперехода,еслинеуказанабудетвзятассылкасайта 可选
filter_lang 字符串 Фильтрация подписчиков по языку (например，俄文） 可选
filter_browser 字符串 Фильтрацияпобраузер,уможетприниматьнесколькозначенийразделенныхзапятой(например-铬，Safari） 可选
filter_region 字符串 Фильтрпорегиону,принимаетJSONстрокусперечнемкодовстран,например,[" UA "] 可选
filter_url 字符串

Фильтр по ссылке， принимает json строку вида{“类型”:“包括”,“搜索”:“pu”}．

类型может иметь три значения -直接，包括и排除．

Если输入равен直接-搜索является массивом ссылок， противном случае -搜索является обычной строкой для поиска

可选
filter_subscription_date_from 字符串 Фильтрподатедобавленияподписчиков(указываетсядатаивремясипотакойтопромежутоквремени)задаетсявформате”Y-m-d(пример: "2018-03-11”) 可选
filter_subscription_date_to 字符串 Фильтрподатедобавленияподписчиков(указываетсядатаивремясипотакойтопромежутоквремени)задаетсявформате”Y-m-d(пример: "2018-03-11”) 可选
过滤器 对象 Сегментация по одной из переменных 可选
stretch_time int Время,втечениекоторогорассылается推——рассылка。Указывается， секундах。Еслинеуказано,используетсявремяпоумолчанию(5часов)。 可选
send_date 字符串 Запланироватьрассылкунаконкретнуюдатунаконкретноевремя:Y-m-d H:我:s,например2020-09-11 16:19:10 可选
按钮 字符串 Добавлениекнопокк推动рассылк,епринимаетJSONстрокусперечнемкнопокиихзначений,например,[{“文本”:“Button1”,“链接”:“link1”}] 可选
图像 字符串

Длявставкибольшогоизображениявпуш——уведомлениепараметр”图像должен содержать json строку вида{" name ": " test.jpg”、“数据”:“file_content”},гдеtest.jpg- имя изображенияfile_contentbase64_encode(содержимоефайла),которо,енапримервPHP,можнополучитьчерез“函数”;

*ИзображениедолжнобытьфайломтипаJPG, PNG、GIFдо200 kb

可选
图标 字符串

Длявставкипользовательскойкартинкистандартногоразмера,данныйпараметрдолженсодержатьJSONстрокувида{" name ": " icon.jpg”、“数据”:“base64_file_content”}
гдеicon.jpg- имя изображенияbase64_file_content- его содержимое

可选

Возможнодобавлениемаксимум10фильтровводнойрассылке。

Пример структуры параметра filter:

{“variable_name”:“uname”、“操作符”:“或”,“条件”:[{“条件”:“像”,“价值”:“a”},{“条件”:“不等号”、“价值”:“b”}]}

где:

Параметр Тип Описание
variable_name 字符串 Имяпеременной
操作符 字符串 Соединяющийоператор,можетприниматьзначениятолько或или和
条件 数组 Массивусловий
条件 Может принимать такие значения:
平等的 Полностьюравно
不等号 Полностью не равно
greaterthan Большечем
不超过 Меньшечем
startwith Начинаетсяс
endwith Заканчивается этим значением
像 Содержит， себе
notlikewith Не содержит， себе
价值 Значениепеременной

В случае успешного запроса вы получите ответ:

{"result": true， "id": 1}

Статистика по отправленным рассылкам

Чтобыполучитьстатистикупоотправленным网络推动рассылкам,отправьте得到запроспоссылке:

https://api.半岛客户端下载官网m.ekobsc.com/push/tasks/ {id}

Параметрзапроса:

Параметр Тип Описание
id int ID推рассылки 要求

В случае успешного запроса вы получите ответ:

{" id ": 36岁的“消息”:{“标题”:“s”、“文本”:“s”,“链接”:“http://aaa。aaa”},“网站”:“www.google.com”,“website_id”:53岁的“状态”:3,“送”:“21”、“交付”:14日“定向”:13}

Таблица статусов рассылки:

Кодстатуса Описание
0 Новаярассылка
2 Отправляется
3. Рассылкаотправлена
8 Тестовая рассылка отправлена
12 Нет активных получателей
13 Рассылкавпроцессесоздания-копированиеподписок
15 Рассылка ожидает итога a / b тестирования
16 Рассылка отменена пользователем
30. Рассылка， архиве
Baidu
map