本文导读：9.消息状态查询9.1消息状态查询接口说明由于目前只返回审计相关信息，单推没有同步返回消息审计状态，其他类型的推送有同步...
vivo广告推广平台：服务端API接口文档《1》
9.消息状态查询
9.1消息状态查询
接口说明
由于目前只返回审计相关信息，单推没有同步返回消息审计状态，其他类型的推送有同步返回。所以可通过调用此接口传递消息id，查询消息的状态。目前有调用频率限制，单个app 1次/s, 建议一批类似的消息体查询一次。
使用：
① 发送消息后查询消息的状态(延时在一分钟内)。
②‘审计通过’或 ‘审计不通过的状态还未入库’，返回 【消息状态未知】，审计不通过状态已入库，返回【消息包含敏感词】
访问方式
URL
编码方式
协议
method
Content-Type
https://api-push.vivo.com.cn/search/msgStatus
Utf-8
https/http
GET
application/json
Curl e.g.：
curl -X GET -H 'authToken:${your_auth_token}' -H 'Content-Type:application/json' -d '${your_request_body}' https://api-push.vivo.com.cn/search/msgStatus?taskIds=taskId1,taskId2
Request body e.g.:
{
"result": 0,
"desc": "success",
"data": [
{
"taskId": taskId1,
"desc": "消息包含敏感词"
},
{
" taskId ": taskId2,
"desc": "消息状态未知"
}
]
}Response body e.g.:
http status 200:
http status 500：
Internet server error!
接口定义
输入参数：
属性名字
类型
是否必填Y/N
描述
taskIds
string
Y
由多个taskId组成的字符串，多个taskId之间用逗号分隔，一次最多查询100个
10.查询失效id
10.1失效id查询
接口说明
由于用户卸载、客户端主动调用turnOffPush()解订阅、设备14天不联网还有一部分历史原因，可能造成推送的id无效。开发者可以根据推送时返回的InvalidUser对失效id做标记或者清除处理，或者单独查询本接口，将无效的id过滤，避免占用推送额度。
使用：
① 传递要查询的id，以及id的类型，后台根据保存的id，返回无效的id。
② 建议在推送低峰期，例如晚上或者凌晨调用，将保存的id一批批查询，避免影响应用的推送性能。勿高频调用。
访问方式
URL
编码方式
协议
method
Content-Type
/invalidUser/check
Utf-8
https/http
POST
application/json
Curl e.g.：
curl -X GET -H 'authToken:${your_auth_token}' -H 'Content-Type:application/json' -d '${your_request_body}' https://api-push.vivo.com.cn/invalidUser/check
Request body e.g.:
{
"userType": 1,
"userIds": [
"15547801220021000000000",
"15547801220021000000001"
]
}
Response body e.g.:
http status 200:
{
"invalidUsers": [
"15547801220021000000000",
"15547801220021000000001"
]
}
http status 500：
Internet server error!
接口定义
输入参数：
属性名字
类型
是否必填Y/N
描述
userIds
string[]
Y
用户id数组 ，单次更大100个
userType
int
Y
userId的类型1:regId,2:alias
11.消息回收
11.1 消息回收接口
接口说明
此接口用于回收已发送给用户的消息。通过传递推送的消息id和具体的用户id、用户类型进行消息回收，消息回收接口调用量和调用速度会占用推送量级和推送速度。
限制：由我司运营人员配置。
消息撤回功能是平台提供给开发者紧急处理运营事故的工具，切勿日常频繁使用，以免对用户体验不当影响。
对于推送内容、应用行为等存在违规的，平台将按《vivo推送运营规则》进行相应处罚。
访问方式
URL
编码方式
协议
method
Content-Type
/message/recycle
Utf-8
https
POST
application/json
Curl e.g.：
curl -X POST -H ' authToken:${your_auth_token}' -H 'Content-Type:application/json' -d '${your_request_body}' https://host:port/message/recycle
Request body e.g.:
{
"taskId":656079923690082304,
"userIds":
[
"15762048080021000000007",
"15762048080021000000008",
"15762048080021000000009"
],
"userType":1
}
Response body e.g.:
http status 200:
业务成功：
{
"result": 0,
"desc": "请求成功",
"invalidUsers": [
{
"status": 1,
"userid": "15762048080021000000008"
},
{
"status": 1,
"userid": "15762048080021000000008"
}
]
}
业务异常：
{
"result": xxx,
"desc": "xxx不合法"
}
http status 500：
Internet server error!
接口定义
输入参数：
属性名字
类型
是否必填Y/N
描述
taskId
string
Y
单播或广播返回的taskId
userIds
string[]
Y
userId列表。个数大于等于1小于等于100
userType
int
Y
用户类型。1：regId；2：alias
输出参数：
属性名字
类型
描述
result
int
接口调用是否成功的状态码 0成功，非0失败
desc
string
文字描述接口调用情况
invalidUsers
JSON Array
非法用户信息，包括status和userid，userid为接入方传的regid或者alias，status有三种情况：1.userId不存在 2.卸载或者关闭了通知 3.七天不在线
美妆广告想要在vivo投放广告可以吗？广告展现样式是怎样的？vivo广告推广账户应该怎样搭建？这些问题在vivo广告渠道服务商网络可以得到解答，我们是专业的vivo广告开户代理商，欢迎有意向的广告主前来咨询！
本文标题：vivo广告推广平台：服务端API接口文档《1》
本文链接：https://www.jianzhaner.com/guanggao/1801.html
关键字：
相关问答：
-
答： 作为一种数字营销手段，广告推广在现代企业的营销中越来越受到重视。伴随着互联网普及和移动设备的普及，vivo广告推广也成为了众多企业进行数字营销的重要手段。但是，在广告推广过程中，如何正确使用定向广告？本文将从基础定向和行为兴趣定向这两个方面进行详细介绍。 一、基础定向 ...
-
答：vivo广告在账号管理过程中是否会遇到这样的问题？1.无法批量复制，只能当个复制，且需逐级复制。2.复制内容只能在当前层级下，无法跨层级。3.广告和创意均不支持复制，创建耗费大量时间。vivo广告复制2.0上线，帮助优化师提升账户管理效率计划层级A类型：仅复制广告计划；B类型：同...
-
答：vivo广告第三方监测链接说明1.1 内容说明vivo 广告平台支持向第三方上报广告监测，本文档说明了 vivo 支持的第三方监测的具体功能，以及广告主对接第三方监测的具体规范，请广告主进行开发对接时参考本说明；vivo 第三方监测规范参照并符合《MMA 中国无线营销联盟移动互...
