推送API

推送API

简述

个推为开发者提供了如下3种消息推送方式:

  • toSingle :简称“单推”,指向单个用户推送消息
  • toList:简称“批量推”,指向指定的一批用户推送消息
  • toApp:简称“群推”,指向APP符合筛选条件的所有用户推送消息,支持定速推送、定时推送,支持条件的交并补功能
  • ClientID简称CID:是个推业务层中的对外用户的唯一标识,用户标识客户端身份;由客户端获取并自己记录保存到自己到服务端;
    安卓cid获取方法(onReceiveClientId) :文档地址
    ios cid获取方法(GeTuiSdkDidRegisterClient):文档地址

【toSingle】执行cid单推

向单个用户推送消息,可根据cid指定用户

  • 接口地址: BaseUrl/push/single/cid
  • 请求方式: POST

Request请求说明:

Header参数说明

名称 类型 是否必须 默认值 说明
token String 接口访问凭据,获取方式请参考获取鉴权token

body参数说明

  • content-type:application/json;charset=utf-8

  • 参数示例

{
  "request_id": "xxx",
  "settings": {
    "ttl": 7200000
  },
  "audience": {
    "cid": [
      "xxx"
    ]
  },
  "push_message": {
    "notification": {
      "title": "请填写通知标题",
      "body": "请填写通知内容",
      "click_type": "url",
      "url": "https//:xxx"
    }
  }
}
  • 请求参数说明
名称 类型 是否必须 默认值 描述
request_id String 请求唯一标识号,10-32位之间;如果request_id重复,会导致消息丢失
group_name String 任务组名。多个消息任务可以用同一个任务组名,后续可根据任务组名查询推送情况(长度限制100字符,且不能含有特殊符号)只允许填写数字、字母、横杠、下划线
audience Json 推送目标用户,详细解释见下方audience说明
settings Json 推送条件设置,详细解释见下方settings说明
push_message Json 个推推送消息参数,详细内容见push_message
push_channel Json 厂商推送消息参数,包含ios消息参数,android厂商消息参数,详细内容见push_channel
  • audience 说明
名称 类型 是否必须 默认值 描述
cid String Array cid数组,只能填一个cid
  • settings 说明
名称 类型 是否必须 默认值 描述
ttl Number 2小时 消息离线时间设置,单位毫秒,-1表示不设离线,-1 ~ 3 * 24 * 3600 * 1000(3天)之间
strategy Json {"strategy":{"default":1}} 厂商通道策略,详细内容见strategy

Response响应说明

成功响应数据格式:

  • content-type: application/json;charset=utf-8

  • http code: 200(http code码说明)

  • 返回值示例

{
  "code": 0,
  "msg": "",
  "data": {
    "$taskid": {
      "$cid": "$status"
    }
  }
}
名称 类型 描述
$taskid Json 任务编号
$cid String key: App的用户唯一标识,value: 推送结果
successed_offline: 离线下发(包含厂商通道下发),
successed_online: 在线下发,
successed_ignore: 最近90天内不活跃用户不下发

请求示例

curl $BaseUrl/push/single/cid -X POST -H "Content-Type: application/json;charset=utf-8" -H "token: $token" -d '{
     "request_id":"xxx",
     "settings":{
         "ttl":7200000
     },
     "audience":{
         "cid":[
             "xxx"
         ]
     },
     "push_message":{
         "notification":{
             "title":"请填写通知标题",
             "body":"请填写通知内容",
             "click_type":"url",
             "url":"https//:xxx"
         }
     }
 }'

【toSingle】执行别名单推

通过别名推送消息,绑定别名请参考接口

  • 接口地址: BaseUrl/push/single/alias
  • 请求方式: POST

Request请求说明:

Header参数说明

名称 类型 是否必须 默认值 说明
token String 接口访问凭据,获取方式请参考获取鉴权token

body参数说明

  • content-type:application/json;charset=utf-8

  • 参数示例

{
  "request_id": "xxx",
  "settings": {
    "ttl": 7200000
  },
  "audience": {
    "alias": [
      "xxx"
    ]
  },
  "push_message": {
    "notification": {
      "title": "请填写通知标题",
      "body": "请填写通知内容",
      "click_type": "url",
      "url": "https//:xxx"
    }
  }
}
  • 请求参数说明
名称 类型 是否必须 默认值 描述
request_id String 请求唯一标识号,10-32位之间;如果request_id重复,会导致消息丢失
audience Json 推送目标用户,详细解释见下方audience说明
settings Json 推送条件设置,详细解释见下方settings说明
push_message Json 个推推送消息参数,详细内容见push_message
push_channel Json 厂商推送消息参数,包含ios消息参数,android厂商消息参数,详细内容见push_channel
  • audience 说明
名称 类型 是否必须 默认值 描述
alias String Array 别名数组,只能填一个别名;绑定别名请参考接口
  • settings 说明
名称 类型 是否必须 默认值 描述
ttl Number 2小时 消息离线时间设置,单位毫秒,-1表示不设离线,-1 ~ 3 * 24 * 3600 * 1000(3天)之间
strategy Json {"strategy":{"default":1}} 厂商通道策略,详细内容见strategy

Response响应说明

成功响应数据格式:

  • content-type: application/json;charset=utf-8

  • http code: 200(http code码说明)

  • 返回值示例

{
  "code": 0,
  "msg": "",
  "data": {
    "$taskid": {
      "$cid": "$status"
    }
  }
}
名称 类型 描述
$taskid Json 任务编号
$cid String key: App的用户唯一标识,value: 推送结果
successed_offline: 离线下发(包含厂商通道下发),
successed_online: 在线下发,
successed_ignore: 最近90天内不活跃用户不下发

请求示例

curl $BaseUrl/push/single/alias -X POST -H "Content-Type: application/json;charset=utf-8" -H "token: $token" -d '{
    "request_id":"xxx",
    "settings":{
        "ttl":7200000
    },
    "audience":{
        "alias":[
            "xxx"
        ]
    },
    "push_message":{
        "notification":{
            "title":"请填写通知标题",
            "body":"请填写通知内容",
            "click_type":"url",
            "url":"https//:xxx"
        }
    }
}'

【toSingle】执行cid批量单推

批量发送单推消息,每个cid用户的推送内容都不同的情况下,使用此接口,可提升推送效率。

  • 接口地址: BaseUrl/push/single/batch/cid
  • 请求方式: POST

Request请求说明:

Header参数说明

名称 类型 是否必须 默认值 说明
token String 接口访问凭据,获取方式请参考获取鉴权token

body参数说明

  • content-type:application/json;charset=utf-8

  • 参数示例

{
  "is_async": true,
  "msg_list": [
    {
      "request_id": "",
      "settings": {
        "ttl": 7200000
      },
      "audience": {
        "cid": [
          "xxxx"
        ]
      },
      "push_message": {
        "notification": {
          "title": "请填写通知标题",
          "body": "请填写通知内容",
          "click_type": "url",
          "url": "https://xxx"
        }
      }
    }
  ]
}
  • 请求参数说明
名称 类型 是否必需 默认值 描述
is_async boolean false 是否异步推送,true是异步,false同步。异步推送不会返回data详情
msg_list Json Array 消息内容,数组长度不大于 200

msg_list

名称 类型 是否必需 默认值 描述
request_id String 请求唯一标识号,10-32位之间;如果request_id重复,会导致消息丢失
audience Json 推送目标用户
settings Json 推送条件设置
push_message Json 个推推送消息参数,详细内容见push_message
push_channel Json 厂商推送消息参数,
包含ios消息参数,android厂商消息参数,详细内容见push_channel

audience

名称 类型 是否必需 默认值 描述
cid String Array cid数组,只能填一个cid

settings

名称 类型 是否必需 默认值 描述
ttl Number 2小时 消息离线时间设置,单位毫秒,-1表示不设离线,-1 ~ 3 * 24 * 3600 * 1000(3天)之间
strategy Json {"strategy":{"default":1}} 厂商通道策略,详细内容见strategy

Response响应说明

成功响应数据格式:

  • content-type: application/json;charset=utf-8

  • http code: 200(http code码说明)

  • 返回值示例

{
  "code": 0,
  "msg": "",
  "data": {
    "$taskid": {
      "$cid": "$status"
    }
  }
}
  • 返回结构说明请参考公共返回结构

  • 返回参数data说明(入参is_async为false时返回此字段)

名称 类型 描述
$taskid Json 任务编号
$cid String key: App的用户唯一标识,value: 推送结果
successed_offline: 离线下发(包含厂商通道下发),
successed_online: 在线下发,
successed_ignore: 最近90天内不活跃用户不下发

请求示例

curl $BaseUrl/push/single/batch/cid -X POST -H "Content-Type: application/json;charset=utf-8" -H "token: $token" -d '{
    "is_async":true,
    "msg_list":[
        {
            "request_id":"",
            "settings":{
                "ttl":7200000
            },
            "audience":{
                "cid":[
                    "xxxx"
                ]
            },
            "push_message":{
                "notification":{
                    "title":"请填写通知标题",
                    "body":"请填写通知内容",
                    "click_type":"url",
                    "url":"https://xxx"
                }
            }
        }
    ]
}'

【toSingle】执行别名批量单推

批量发送单推消息,在给每个别名用户的推送内容都不同的情况下,可以使用此接口

  • 接口地址: BaseUrl/push/single/batch/alias
  • 请求方式: POST

Request请求说明:

Header参数说明

名称 类型 是否必须 默认值 说明
token String 接口访问凭据,获取方式请参考获取鉴权token

body参数说明

  • content-type:application/json;charset=utf-8

  • 参数示例

{
  "is_async": true,
  "msg_list": [
    {
      "request_id": "",
      "settings": {
        "ttl": 7200000
      },
      "audience": {
        "alias": [
          "xxxx"
        ]
      },
      "push_message": {
        "notification": {
          "title": "请填写通知标题",
          "body": "请填写通知内容",
          "click_type": "url",
          "url": "https://xxx"
        }
      }
    }
  ]
}
  • 请求参数说明
名称 类型 是否必需 默认值 描述
is_async boolean false 是否异步推送,true是异步,false同步。异步推送不会返回data详情
msg_list Json Array 消息内容,数组长度不大于200

msg_list

名称 类型 是否必需 默认值 描述
request_id String 请求唯一标识号,10-32位之间;如果request_id重复,会导致消息丢失
audience Json 推送目标用户
settings Json 推送条件设置
push_message Json 个推推送消息参数,详细内容见push_message
push_channel Json 厂商推送消息参数,
包含ios消息参数,android厂商消息参数,详细内容见push_channel

audience

名称 类型 是否必需 默认值 描述
alias String Array 别名数组,只能填一个别名;绑定别名请参考接口

settings

名称 类型 是否必需 默认值 描述
ttl Number 2小时 消息离线时间设置,单位毫秒,-1表示不设离线,-1 ~ 3 * 24 * 3600 * 1000(3天)之间
strategy Json {"strategy":{"default":1}} 厂商通道策略,详细内容见strategy

Response响应说明

成功响应数据格式:

  • content-type: application/json;charset=utf-8

  • http code: 200(http code码说明)

  • 返回值示例

{
  "code": 0,
  "msg": "",
  "data": {
    "$taskid": {
      "$cid": "$status"
    }
  }
}
  • 返回结构说明请参考公共返回结构

  • 返回参数data说明(入参is_async为false时返回此字段)

名称 类型 描述
$taskid Json 任务编号
$cid String key: App的用户唯一标识,value: 推送结果
successed_offline: 离线下发(包含厂商通道下发),
successed_online: 在线下发,
successed_ignore: 最近90天内不活跃用户不下发

请求示例

curl $BaseUrl/push/single/batch/alias -X POST -H "Content-Type: application/json;charset=utf-8" -H "token: $token" -d '{
     "is_async":true,
     "msg_list":[
         {
             "request_id":"",
             "settings":{
                 "ttl":7200000
             },
             "audience":{
                 "alias":[
                     "xxxx"
                 ]
             },
             "push_message":{
                 "notification":{
                     "title":"请填写通知标题",
                     "body":"请填写通知内容",
                     "click_type":"url",
                     "url":"https://xxx"
                 }
             }
         }
     ]
    }'

【toList】创建消息

此接口用来创建消息体,并返回taskid,为批量推的前置步骤
注:此接口频次限制200万次/天,申请修改请点击右侧“技术咨询”了解详情。

  • 接口地址: BaseUrl/push/list/message
  • 请求方式: POST

Request请求说明:

Header参数说明

名称 类型 是否必须 默认值 说明
token String 接口访问凭据,获取方式请参考获取鉴权token

body参数说明

  • content-type:application/json;charset=utf-8

  • 参数示例

{
  "group_name": "请填写任务组名",
  "settings": {
    "ttl": 7200000
  },
  "push_message": {
    "notification": {
      "title": "请填写通知标题",
      "body": "请填写通知内容",
      "click_type": "url",
      "url": "https//:xxx"
    }
  }
}
  • 请求参数说明
名称 类型 是否必需 默认值 描述
group_name String 任务组名(只允许填写数字、字母、横杠、下划线)
settings Json 推送条件设置
push_message Json 个推推送消息参数,详细内容见push_message
push_channel Json 厂商推送消息参数,
包含ios消息参数,android厂商消息参数,详细内容见push_channel

settings

名称 类型 是否必需 默认值 描述
ttl Number 2小时 消息离线时间设置,单位毫秒,-1表示不设离线,-1 ~ 3 * 24 * 3600 * 1000(3天)之间
strategy Json {"strategy":{"default":1}} 厂商通道策略,详细内容见strategy

Response响应说明

成功响应数据格式:

  • content-type: application/json;charset=utf-8

  • http code: 200(http code码说明)

  • 返回值示例

{
  "code": 0,
  "msg": "",
  "data": {
    "taskid": ""
  }
}
名称 类型 描述
taskid String 任务编号,用于执行cid批量推执行别名批量推,此taskid可以多次使用,有效期为用户设置的离线时间

请求示例

curl $BaseUrl/push/list/message -X POST -H "Content-Type: application/json;charset=utf-8" -H "token: $token" -d '{
    "group_name":"请填写任务组名",
    "settings":{
        "ttl":7200000
    },
    "push_message":{
        "notification":{
            "title":"请填写通知标题",
            "body":"请填写通知内容",
            "click_type":"url",
            "url":"https//:xxx"
        }
    }
}'

【toList】执行cid批量推

对列表中所有cid进行消息推送。调用此接口前需调用创建消息接口设置消息内容。

  • 接口地址: BaseUrl/push/list/cid
  • 请求方式: POST

Request请求说明:

Header参数说明

名称 类型 是否必须 默认值 说明
token String 接口访问凭据,获取方式请参考获取鉴权token

body参数说明

  • content-type:application/json;charset=utf-8

  • 参数示例

{
  "audience": {
    "cid": [
      "xxxx1",
      "xxxx2"
    ]
  },
  "taskid": "",
  "is_async": true
}
  • 请求参数说明
名称 类型 是否必需 默认值 描述
audience Json 推送目标用户
is_async boolean false 是否异步推送,true是异步,false同步。异步推送不会返回data详情
taskid String 使用创建消息接口返回的taskId,可以多次使用

audience

名称 类型 是否必需 默认值 描述
cid String Array cid数组,数组长度不大于1000
smart_crowd_task_id String 文案圈人任务ID,必须是can_push为true的ID才可以进行推送
crowd_id String 用户群ID,仅“用户群管理”模块中的“用户群”在去触达状态生效时可使用

说明:cid、smart_crowd_task_id、crowd_id必须3选1

Response响应说明

成功响应数据格式:

  • content-type: application/json;charset=utf-8

  • http code: 200(http code码说明)

  • 返回值示例

{
  "code": 0,
  "msg": "",
  "data": {
    "$taskid": {
      "$cid": "$status"
    }
  }
}
  • 返回结构说明请参考公共返回结构

  • 返回参数data说明(当is_async=false时返回此字段)

名称 类型 描述
$taskid Json 任务编号
$cid String key: App的用户唯一标识,value: 推送结果
successed_offline: 离线下发(包含厂商通道下发),
successed_online: 在线下发,
successed_ignore: 最近90天内不活跃用户不下发

请求示例

curl $BaseUrl/push/list/cid -X POST -H "Content-Type: application/json;charset=utf-8" -H "token: $token" -d '{
    "audience": {
        "cid": [
            "xxxx1",
            "xxxx2"
        ]
    },
    "taskid": "",
    "is_async": true
}'

【toList】执行别名批量推

对列表中所有别名进行消息推送。调用此接口前需调用创建消息接口设置消息内容。

  • 接口地址: BaseUrl/push/list/alias
  • 请求方式: POST

Request请求说明:

Header参数说明

名称 类型 是否必须 默认值 说明
token String 接口访问凭据,获取方式请参考获取鉴权token

body参数说明

  • content-type:application/json;charset=utf-8

  • 参数示例

{
  "audience": {
    "alias": [
      "xxxx1",
      "xxxx2"
    ]
  },
  "taskid": "",
  "is_async": true
}
  • 请求参数说明
名称 类型 是否必需 默认值 描述
audience Json 推送目标用户
is_async boolean false 是否异步推送,true是异步,false同步。异步推送不会返回data详情
taskid String 使用创建消息接口返回的taskId,可以多次使用
need_alias_detail boolean false 是否返回别名详情,返回别名详情的前提:is_async=false

audience

名称 类型 是否必需 默认值 描述
alias String Array alias数组,数组长度不大于1000;绑定别名请参考接口

Response响应说明

成功响应数据格式:

  • content-type: application/json;charset=utf-8

  • http code: 200(http code码说明)

  • 返回值示例

{
  "code": 0,
  "msg": "",
  "data": {
    "$taskid": {
      "$cid": "successed_offline"
    }
  }
}

当is_async=false,need_alias_detail=true时,返回别名详情,返回结构如下

{
  "msg": "success",
  "code": 0,
  "data": {
    "$taskid": {
      "$alias1": {
        "$cid1": "successed_online",
        "$cid2": "successed_offline"
      },
      "$alias2": {
        "$cid3": "successed_online",
        "$cid4": "successed_ignore"
      }
    }
  }
}
  • 返回结构说明请参考公共返回结构

  • 返回参数data说明(当is_async=false时返回此字段)

名称 类型 描述
$taskid Json 任务编号
$cid String key: App的用户唯一标识,别名绑定的cid,value: 推送结果
successed_offline: 离线下发(包含厂商通道下发),
successed_online: 在线下发,
successed_ignore: 最近90天内不活跃用户不下发
$alias String 推送时传的别名

请求示例

curl $BaseUrl/push/list/alias -X POST -H "Content-Type: application/json;charset=utf-8" -H "token: $token" -d '{
    "audience": {
        "alias": [
            "xxxx1",
            "xxxx2"
        ]
    },
    "taskid": "",
    "is_async": true
}'

【toApp】执行群推

对指定应用的所有用户群发推送消息。支持定时、定速功能,查询任务推送情况请见接口查询定时任务
注:此接口频次限制20次/天,每分钟不能超过5次(推送限制和接口根据条件筛选用户推送共享限制)

  • 接口地址: BaseUrl/push/all
  • 请求方式: POST

Request请求说明:

Header参数说明

名称 类型 是否必须 默认值 说明
token String 接口访问凭据,获取方式请参考获取鉴权token

body参数说明

  • content-type:application/json;charset=utf-8

  • 参数示例

{
  "request_id": "请填写requestid",
  "group_name": "请填写任务组名",
  "settings": {
    "ttl": 7200000
  },
  "audience": "all",
  "push_message": {
    "notification": {
      "title": "请填写通知标题",
      "body": "请填写通知内容",
      "click_type": "url",
      "url": "https//:xxx"
    }
  }
}
  • 请求参数说明
名称 类型 是否必需 默认值 描述
request_id String 请求唯一标识号,10-32位之间;如果request_id重复,会导致消息丢失
group_name String 任务组名(只允许填写数字、字母、横杠、下划线)
audience Json 推送目标用户该接口audience 对应值为all,表示推送所有用户
settings Json 推送条件设置
push_message Json 个推推送消息参数,详细内容见push_message
push_channel Json 厂商推送消息参数,
包含ios消息参数,android厂商消息参数,详细内容见push_channel

settings

名称 类型 是否必需 默认值 描述
ttl Number 2小时 消息离线时间设置,单位毫秒,-1表示不设离线,-1 ~ 3 * 24 * 3600 * 1000(3天)之间
strategy Json {"strategy":{"default":1}} 厂商通道策略,详细内容见strategy
speed Number 0 定速推送,例如100,个推控制下发速度在100条/秒左右,0表示不限速
schedule_time Number 定时推送时间,必须是7天内的时间,格式:毫秒时间戳,此功能需要开通VIP,如需开通请点击右侧“技术咨询”了解详情

Response响应说明

成功响应数据格式:

  • content-type: application/json;charset=utf-8

  • http code: 200(http code码说明)

  • 返回值示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "taskid": ""
  }
}
名称 类型 描述
taskid String 任务编号

请求示例

curl $BaseUrl/push/all -X POST -H "Content-Type: application/json;charset=utf-8" -H "token: $token" -d '{
    "request_id":"请填写requestid",
    "group_name":"请填写任务组名",
    "settings":{
        "ttl":7200000
    },
    "audience":"all",
    "push_message":{
        "notification":{
            "title":"请填写通知标题",
            "body":"请填写通知内容",
            "click_type":"url",
            "url":"https//:xxx"
        }
    }
}'

【toApp】根据条件筛选用户推送

对指定应用的符合筛选条件的用户群发推送消息。支持定时、定速功能。
注:此接口频次限制20次/天,每分钟不能超过5次(推送限制和接口执行群推共享限制),定时推送功能需要申请开通才可以使用,申请修改请点击右侧“技术咨询”了解详情。
注:个推用户画像中的,单身、已婚、彩票类标签已经下架,请开发者及时关注和处理。

  • 接口地址: BaseUrl/push/tag
  • 请求方式: POST

Request请求说明:

Header参数说明

名称 类型 是否必须 默认值 说明
token String 接口访问凭据,获取方式请参考获取鉴权token

body参数说明

  • content-type:application/json;charset=utf-8

  • 参数示例

{
  "request_id": "请填写requestid",
  "group_name": "请填写任务组名",
  "settings": {
    "ttl": 7200000
  },
  "audience": {
    "tag": [
      {
        "key": "phone_type",
        "values": [
          "android"
        ],
        "opt_type": "and"
      },
      {
        "key": "region",
        "values": [
          "11000000"
        ],
        "opt_type": "not"
      },
      {
        "key": "custom_tag",
        "values": [
          "0901",
          "0902"
        ],
        "opt_type": "or"
      },
      {
        "key": "portrait",
        "values": [
          "si1003",
          "si1100"
        ],
        "opt_type": "or"
      }
    ]
  },
  "push_message": {
    "notification": {
      "title": "请填写通知标题",
      "body": "请填写通知内容",
      "click_type": "url",
      "url": "https//:xxx"
    }
  }
}
  • 请求参数说明
名称 类型 是否必需 默认值 描述
request_id String 请求唯一标识号,10-32位之间;如果request_id重复,会导致消息丢失
group_name String 任务组名(只允许填写数字、字母、横杠、下划线)
audience Json 推送目标用户
settings Json 推送条件设置
push_message Json 个推推送消息参数,详细内容见push_message
push_channel Json 厂商推送消息参数,
包含ios消息参数,android厂商消息参数,详细内容见push_channel

audience

名称 类型 是否必需 默认值 描述
tag Json Array 推送条件,详见下方说明,数量不大于100个

tag

名称 类型 是否必需 默认值 描述
key String 查询条件(phone_type 手机类型; region 省市; custom_tag 用户标签; portrait 个推用户画像。设置用户标签(custom_tag)请见接口)
values String Array 查询条件值列表,其中
phone_type 手机类型枚举值如下android安卓系统,ios苹果系统,harmony纯血鸿蒙系统(HarmonyOS NEXT)和miniProgram小程序或web;
省市使用编号,点击下载文件region_code.data
个推用户画像使用编码,点击下载文件portrait.data
opt_type String or(或),and(与),not(非),values间的交并补操作
  • 不同key之间是交集,同一个key之间是根据opt_type操作
  • eg. 需要发送给城市在A,B,C里面,没有设置tagtest标签,手机型号为android的用户,用条件交并补功能可以实现,city(A|B|C) && !tag(tagtest) && phonetype(android)

settings

名称 类型 是否必需 默认值 描述
ttl Number 2小时 消息离线时间设置,单位毫秒,-1表示不设离线,-1 ~ 3 * 24 * 3600 * 1000(3天)之间
strategy Json {"strategy":{"default":1}} 厂商通道策略,详细内容见strategy
speed Number 0 定速推送,例如100,个推控制下发速度在100条/秒左右,0表示不限速
schedule_time Number 定时推送时间,必须是7天内的时间,格式:毫秒时间戳,此功能需要开通VIP,如需开通请点击右侧“技术咨询”了解详情

Response响应说明

成功响应数据格式:

  • content-type: application/json;charset=utf-8

  • http code: 200(http code码说明)

  • 返回值示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "taskid": ""
  }
}
名称 类型 描述
taskid String 任务编号

请求示例

curl $BaseUrl/push/tag -X POST -H "Content-Type: application/json;charset=utf-8" -H "token: $token" -d '{
    "request_id":"请填写requestid",
    "group_name":"请填写任务组名",
    "settings":{
        "ttl":7200000
    },
    "audience":{
        "tag":[
            {
                "key":"phone_type",
                "values":[
                    "android"
                ],
                "opt_type":"or"
            },
            {
                "key":"region",
                "values":[
                    "11000000"
                ],
                "opt_type":"and"
            }
        ]
    },
    "push_message":{
        "notification":{
            "title":"请填写通知标题",
            "body":"请填写通知内容",
            "click_type":"url",
            "url":"https//:xxx"
        }
    }
}'

【toApp】使用标签快速推送

根据标签过滤用户并推送。支持定时、定速功能。
注:该功能需要申请相关套餐,请点击右侧“技术咨询”了解详情 。

  • 接口地址: BaseUrl/push/fast_custom_tag
  • 请求方式: POST

Request请求说明:

Header参数说明

名称 类型 是否必须 默认值 说明
token String 接口访问凭据,获取方式请参考获取鉴权token

body参数说明

  • content-type:application/json;charset=utf-8

  • 参数示例

{
  "request_id": "请填写requestid",
  "group_name": "请填写任务组名",
  "settings": {
    "ttl": 7200000
  },
  "audience": {
    "fast_custom_tag": "xxxx"
  },
  "push_message": {
    "notification": {
      "title": "请填写通知标题",
      "body": "请填写通知内容",
      "click_type": "url",
      "url": "https//:xxx"
    }
  }
}
  • 请求参数说明
名称 类型 是否必需 默认值 描述
request_id String 请求唯一标识号,10-32位之间;如果request_id重复,会导致消息丢失
audience Json 推送目标用户
settings Json 推送条件设置
push_message Json 个推推送消息参数,详细内容见push_message
push_channel Json 厂商推送消息参数,
包含ios消息参数,android厂商消息参数,详细内容见push_channel

audience

名称 类型 是否必需 默认值 描述
fast_custom_tag String 使用用户标签筛选目标用户,绑定标签请参考接口

settings

名称 类型 是否必需 默认值 描述
ttl Number 2小时 消息离线时间设置,单位毫秒,-1表示不设离线,-1 ~ 3 * 24 * 3600 * 1000(3天)之间
strategy Json {"strategy":{"default":1}} 厂商通道策略,详细内容见strategy
speed Number 0 定速推送,例如100,个推控制下发速度在100条/秒左右,0表示不限速

Response响应说明

成功响应数据格式:

  • content-type: application/json;charset=utf-8

  • http code: 200(http code码说明)

  • 返回值示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "taskid": ""
  }
}
名称 类型 描述
taskid String 任务编号

请求示例

curl $BaseUrl/push/fast_custom_tag -X POST -H "Content-Type: application/json;charset=utf-8" -H "token: $token" -d '{
    "request_id":"请填写requestid",
    "group_name":"请填写任务组名",
    "settings":{
        "ttl":7200000
    },
    "audience":{
        "fast_custom_tag":"xxxx"
    },
    "push_message":{
        "notification":{
            "title":"请填写通知标题",
            "body":"请填写通知内容",
            "click_type":"url",
            "url":"https//:xxx"
        }
    }
}'

【任务】停止任务

对正处于推送状态,或者未接收的消息停止下发(只支持批量推和群推任务)

  • 接口地址: BaseUrl/task/$taskid
  • 请求方式: DELETE

Request请求说明:

路径参数说明(路径中$开头的参数)

名称 类型 是否必须 默认值 说明
taskId String 任务id (格式RASL-MMdd_XXXXXX或RASA-MMdd_XXXXXX)

Header参数说明

名称 类型 是否必须 默认值 说明
token String 接口访问凭据,获取方式请参考获取鉴权token

Response响应说明

成功响应数据格式:

  • content-type:application/json;charset=utf-8

  • 返回值示例

 {
  "code": 0,
  "msg": "success"
}

请求示例

curl $BaseUrl/task/$taskid -X DELETE -H "token: xxx" 

【任务】查询定时任务

该接口支持在推送完定时任务之后,查看定时任务状态,定时任务是否发送成功。
创建定时任务请见接口执行群推

  • 接口地址: BaseUrl/task/schedule/$taskid
  • 请求方式: GET

Request请求说明:

路径参数说明(路径中$开头的参数)

名称 类型 是否必须 默认值 说明
taskId String 任务id

Header参数说明

名称 类型 是否必须 默认值 说明
token String 接口访问凭据,获取方式请参考获取鉴权token

Response响应说明

成功响应数据格式:

  • content-type:application/json;charset=utf-8

  • 返回值示例

 {
  "code": 0,
  "msg": "success",
  "data": {
    "$taskid": {
      "create_time": "2024-07-24 09:43:07",
      "send_result": "do_not_send",
      "push_time": "202407250900",
      "transmission_content": ""
    }
  }
}
名称 类型 描述
$taskid Json key: 任务编号,value: 任务数据
create_time String 定时任务创建时间,格式:yyyy-MM-dd HH:mm:ss
send_result String 定时任务状态:send_success/do_not_send/send_failed/has_delete
transmission_content String 透传内容
push_time String 定时任务推送时间,格式:yyyyMMddHHmm

请求示例

curl $BaseUrl/task/schedule/$taskid -H "token: xxx" 

【任务】删除定时任务

用来删除还未下发的任务,删除后定时任务不再触发(距离下发还有一分钟的任务,将无法删除,后续可以调用停止任务接口。)

  • 接口地址: BaseUrl/task/schedule/$taskid
  • 请求方式: DELETE

Request请求说明:

路径参数说明(路径中$开头的参数)

名称 类型 是否必须 默认值 说明
taskId String 任务id

Header参数说明

名称 类型 是否必须 默认值 说明
token String 接口访问凭据,获取方式请参考获取鉴权token

Response响应说明

成功响应数据格式:

  • content-type:application/json;charset=utf-8

  • 返回值示例

 {
  "code": 0,
  "msg": "success"
}

请求示例

curl $BaseUrl/task/schedule/$taskid -X DELETE -H "token: xxx" 

【推送】查询消息明细

调用此接口可以查询某任务下某cid的具体实时推送路径情况

使用该接口需要申请权限,若有需要,请点击右侧“技术咨询”了解详情

  • 接口地址: BaseUrl/task/detail/${cid}/${taskid}
  • 请求方式: GET

Request请求说明:

路径参数说明(路径中$开头的参数)

名称 类型 是否必须 默认值 说明
taskId string true 任务id
cid string true cid

Header参数说明

名称 类型 是否必须 默认值 说明
token String 接口访问凭据,获取方式请参考获取鉴权token

Response响应说明

成功响应数据格式:

  • content-type:application/json;charset=utf-8

  • 返回值示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "deatil": [
      {
        "time": "yyyy-MM-dd HH:mm:ss",
        "event": "消息请求成功"
      },
      {
        "time": "yyyy-MM-dd HH:mm:ss",
        "event": "到达客户端"
      }
    ]
  }
}
名称 类型 描述
detail array 请求返回详细数据
time String 时间,格式:yyyy-MM-dd HH:mm:ss
event String 事件

请求示例

curl $BaseUrl/task/detail/${cid}/${taskid} -H "token: xxx" 
开发者中心 SDK 下载

文档中心搜索

技术
咨询

微信扫一扫

随时联系技术支持

在线
咨询