接口简介

  • 本接口用于创建一条友盟推送任务

重要说明:因接口比较特殊,万一被恶意利用或者使用不当,可能会造成不可估量的后果,所以该接口暂时不对外开放。确实有需求的站点可以联系千帆进行开通,并且在千帆的指导下进行相关开发工作。

接口请求说明

请求方式

POST https://{hostname}.qianfanapi.com/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://qianfan-local.qianfanapi.com:8080/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   作者:mondoc-chenyuzou