MobPush 撤回/取消推送原创

MobService

发布于 2024-7-2 18:04

浏览

0收藏

调用验证

详情参见 REST API 概述的鉴权方式说明。

频率控制

详情参见推送限制策略的接口限制说明。

取消任务

调用地址

POSThttp://api.push.mob.com/push/drop

推送对象

以 JSON 格式表达，表示一条推送相关的所有信息

参数	类型	必须	说明
appkey	string	是	Mob后台的MobAppKey
batchId	string	是	任务id

请求示例

curl --location --request POST 'http://api.push.mob.com/push/drop' 
--header 'Content-Type: application/json' 
--header 'key: 2e76e2e95a7ad' 
--header 'sign: fe7ad5d3f73108ac20b660bbf352ece3' 
--data-raw '{"appkey":"2e76e2e95a7ad","batchId":"2jkq3pzasp3l23hyaghs"}'

响应示例

请求成功

{
    "status": 200,
    "res": {
       "batchId": null,
       "code": 1,
       "status": 7,
       "errorMsg": null
    },
    "error": null

请求失败

{
    "status": 5801,
    "res": null,
    "error": "数据校验失败"

响应参数

参数	类型	说明
status	number	返回码
res	object	消息体
res.batchId	string	任务id
res.code	number	0 失败 1 成功
res.status	number	操作类型： 7 取消 9 撤回 10 替换
res.errorMsg	string	错误信息描述
error	string	返回码描述

撤回任务

调用地址

POSThttp://api.push.mob.com/push/recall

推送对象

以 JSON 格式表达，表示一条推送相关的所有信息

参数	类型	必须	说明
appkey	string	是	Mob后台的MobAppKey
batchId	string	是	任务id

请求示例

curl --location --request POST 'http://api.push.mob.com/push/recall' \
--header 'Content-Type: application/json' \
--header 'key: 2e76e2e95a7ad' \
--header 'sign: 83f43fac22fad13a0a32dd81a626f739' \
--data-raw '{"appkey":"2e76e2e95a7ad","batchId":"2jkq3pzasp3fomi0eqyo"}'

响应示例

请求成功

{
    "status": 200,
    "res": {
        "batchId": "2jkq09ume37wvkd7n668",
        "code": 1,
        "status": 9,
        "errorMsg": null
    },
    "error": null

请求失败

{
    "status": 5801,
    "res": null,
    "error": "数据校验失败"

响应参数

参数	类型	说明
status	number	返回码
res	object	消息体
res.batchId	string	任务id
res.code	number	0 失败 1 成功
res.status	number	操作类型： 7 取消 9 撤回 10 替换
res.errorMsg	string	错误信息描述
error	string	返回码描述