接口简介
- 本接口用于创建一条友盟推送任务
重要说明:因接口比较特殊,万一被恶意利用或者使用不当,可能会造成不可估量的后果,所以该接口暂时不对外开放。确实有需求的站点可以联系千帆进行开通,并且在千帆的指导下进行相关开发工作。
接口请求说明
请求方式
POST https://站点接口域名/openapi/pushes
请求参数
参数名 | 类型 | 是否必须 | 说明 |
---|---|---|---|
title | string | ✅ | 标题 |
content | string | ✅ | 内容 |
image | string | 图片(必须是https) | |
method | int | ✅ | 推送时效:0-立即推送 1-定时推送 |
cast_type | int | ✅ | 推送方式:0-广播推送 1分组推送 |
platform | int | ✅ | 推送平台:0-双平台 1-iOS平台 2-Android平台 |
target_type | int | ✅ | 跳转类型 |
target_value | string | ✅ | 跳转目标值 |
start_at | int | 推送开始时间戳,只有设置mothod=1定时推送时才生效 |
关于method字段的补充说明:
- 0立即推送:立即推送即创建消息后立刻进行推送,但是千帆实际上会在创建消息1分钟之后开始真正推送。
- 1定时推送:设定需要推送的时间点,请注意这个时间点必须大于当前时间,否则无法创建推送。
请求示例
curl -X POST 'http://站点接口域名/openapi/pushes' \
-H 'Authorization: Bearer 5d40e72b0f5ba' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'title=test-data&content=content&method=1&cast_type=1&platform=0&target_type=10&target_value=121&start_at=1568023200'
接口响应说明
响应示例
{
"code": 0,
"text": "",
"data": {
"id": 436,
"title": "test-data",
"content": "content",
"image": "",
"target_type": "10",
"target_value": "121",
"direct": "",
"method": "1",
"cast_type": "1",
"platform": "0",
"created_time": "2019-09-09 14:25:36",
"start_time": "2019-09-09 18:00:00"
},
"time": 1568010337
}
响应结果说明
字段名 | 类型 | 说明 |
---|---|---|
id | int | id |
title | string | 标题 |
content | string | 内容 |
image | string | 图片 |
target_type | int | 跳转类型 |
target_value | string | 跳转目标 |
direct | string | 协议跳转地址 |
method | int | 推送时效:0-立即推送 1-定时推送 |
cast_type | int | 推送方式:0-广播推送 1-分组推送 |
platform | int | 推送平台:0-双平台 1-iOS平台 2-android平台 |
created_time | string | 创建时间 |
start_time | string | 推送时间 |
跳转类型target_type
值 | 说明 |
---|---|
10 | 跳转帖子详情 |
20 | 跳转首页 |
30 | 跳转本地圈详情 |
40 | 跳转话题页 |
50 | 跳转H5页面(也支持客户端原生页面) |
80 | 跳转交友推荐页面 |
90 | 跳转图文专题页面 |
100 | 兼容分类信息跳转 |
文档更新时间: 2019-09-17 10:08 作者:千帆云