OPPO开放平台OPPO消息推送标签管理

标签管理

添加标签

接口

环境	HTTPS请求地址	备注
生产环境	https://api-device.push.heytapmobi.com/	设备API
沙箱环境	暂无

描述	内容
接口功能	新增标签
请求方法	POST
Content-Type	application/json
请求编码	UTF-8
请求路径	/server/v1/device/add_tags

请求参数

名称	类型	必须	默认	描述
name	String	是	无	标签名称,字符长度50字符
desc	String	是	无	标签描述,字符长度200字符

响应参数（JSON）

名称	类型	必须	描述
code	Int	是	返回码,请参考公共返回码与接口返回码
message	String	否	错误详细信息，不存在则不填
data	String	否	返回值，JSON类型，包含响应结构体

响应示例

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

添加标签组

接口

描述	内容
接口功能	新增标签,app全局最多可新增1000个标签组
请求方法	POST
Content-Type	application/json
请求编码	UTF-8
请求路径	/server/v1/device/add_tag_group

请求参数

名称	类型	必须	默认	描述
group	String	是	无	标签组名称
tags	String	是	无	标签列表，单个标签组最多可设置50个标签；多个标签之间使用英文分号分隔
desc	String	是	无	标签描述

响应参数（JSON）

名称	类型	必须	描述
code	Int	是	返回码,请参考公共返回码与接口返回码
message	String	否	错误详细信息，不存在则不填
data	String	否	返回值，JSON类型，包含响应结构体

响应示例

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

标签订阅接口

接口

描述	内容
接口功能	为指定设备绑定标签
请求方法	POST
Content-Type	application/json
请求编码	UTF-8
请求路径	/server/v1/device/subscribe_tags

请求参数

名称	类型	必须	默认	描述
registration_id	String	是	Null	注册ID
tags	String	是	Null	标签内容,多个标签之间使用英文分号分隔，单个标签字节长度50字符；限制：单次调用接口可设置50个标签；单个用户总量上限也是50个标签这个接口可重复调用，多次调用不会清理原来设置的标签

响应参数（JSON）

名称	类型	必须	描述
code	Int 是		返回码,请参考公共返回码与接口返回码
message	String	否	错误详细信息，不存在则不填
data	String	否	返回值，JSON类型，包含响应结构体

响应示例

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

取消标签订阅接口

接口

描述	内容
接口功能	取消订阅标签
请求方法	POST
Content-Type	application/json
请求编码	UTF-8
请求路径	/server/v1/device/unsubscribe_tags

请求参数

名称	类型	必须	默认	描述
registration_id	String	是	Null	注册ID
tags	String	是	Null	标签内容,多个标签之间使用分号分隔限制：单次调用接口可删除50个标签

响应参数（JSON）

名称	类型	必须	描述
code	Int	是	返回码,请参考公共返回码与接口返回码
message	String 否	错误详细信息，不存在则不填
data	String	否	返回值，JSON类型，包含响应结构体

响应示例

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

查询所有标签

接口

描述	内容
接口功能	查询该设备所有标签
请求方法	POST
Content-Type	application/json
请求编码	UTF-8
请求路径	/server/v1/device/get_all_tags

请求参数

名称	类型	必须	默认	描述
registration_id	String	是	Null	注册ID

响应参数（JSON）

名称	类型	必须	描述
code	Int	是	返回码,请参考公共返回码与接口返回码
message	String	否	错误详细信息，不存在则不填
data	String	否	返回值，JSON类型，包含响应结构体

响应示例

{
    "code": 0,
    "message": "success",
    "data": {
        "registrationId": "58ad47319e8d725350a5afd5",
        "tags": [
            {
                "tag": "深圳"
            },
            {
                "tag": "广州"
            }
        ]
    }
}

编辑：yimen，如若转载，请注明出处：https://www.yimenapp.com/kb-yimen/11089/

部分内容来自网络投稿，如有侵权联系立删