MobPush 标签别名 API

调用验证

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

频率控制

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

查询设备信息

根据RegistrationId

调用地址

GET http://api.push.mob.com/device-v3/getById/{registrationId}
推送对象
查询设备信息

根据RegistrationId

调用地址

GET http://api.push.mob.com/device-v3/getById/{registrationId}
推送对象

请求示例

curl --location --request GET 'http://api.push.mob.com/device-v3/getById/65l0soev0d0b4lc' \ 
--header 'Content-Type: application/x-www-form-urlencoded' \ 
--header 'key: 2e08782eb311b' \ 
--header 'sign: 9f1bb16df0167c733eb83875dfe445db'

响应示例

请求成功

{
    "status": 200,
    "res": {
        "registrationId": "65l0soev0d0b4lc",
        "tags": [
            "TestTag2",
            "TestTag1"
        ],
        "alias": "TestAlias",
        "mobile": null,
        "openPush": 1,
        "status": 1,
        "customParam": {
            "person": "ax"
        }
    },
    "error": null
}

请求失败

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

调用地址

GET http://api.push.mob.com/device-v3/getByAlias/{alias}
推送对象

请求示例

curl --location --request GET 'http://api.push.mob.com/device-v3/getByAlias/TestAlias' \ 
--header 'Content-Type: application/x-www-form-urlencoded' \ 
--header 'key: 2e08782eb311b' \ 
--header 'sign: 9f1bb16df0167c733eb83875dfe445db'

响应示例

请求成功

{
    "status": 200,
    "res": {
        "registrationId": "65l0soev0d0b4lc",
        "tags": [
            "TestTag2",
            "TestTag1"
        ],
        "alias": "TestAlias",
        "mobile": null,
        "openPush": 1,
        "status": 1
    },
    "error": null
}

请求失败

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

响应参数

根据标签

目前该接口只返回1000条设备相关信息

调用地址

POST http://api.push.mob.com/device-v3/queryByTags
推送对象

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

请求示例

curl --location --request POST 'http://api.push.mob.com/device-v3/queryByTags' \ 
--header 'key: 2e08782eb311b' \ 
--header 'sign: adf46949ac9ba0732e966d2fb43eebf3' \ 
--header 'Content-Type: application/json' \ 
--data-raw '{"appkey":"2e08782eb311b","tags":["TestTag2"]}'

返回示例

请求成功

{
    "status": 200,
    "res": [
        {
            "registrationId": "65l0soev0d0b4lc",
            "tags": [
                "TestTag2",
                "TestTag1"
            ],
            "alias": "TestAlias",
            "mobile": null,
            "openPush": 1,
            "status": 1
        }
    ],
    "error": null
}

请求失败

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

响应参数

更新标签

调用地址

POST http://api.push.mob.com/device-v3/updateTags
推送对象

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

请求示例

curl --location --request POST 'http://api.push.mob.com/device-v3/updateTags' \ 
--header 'key: 2e08782eb311b' \ 
--header 'sign: 5abb496fcc0da0de1df3c377791fb1f1' \ 
--header 'Content-Type: application/json' \ 
--data-raw '{
    "appkey":"2e08782eb311b",
    "registrationId":"65l0soev0d0b4lc",
    "opType":"1",
    "tags":["TestTag3","TestTag4"]
}'

返回示例

请求成功

{
    "status": 200,
    "res": null,
    "error": null
}

请求失败

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

响应参数

更新别名

调用地址

POST http://api.push.mob.com/device-v3/updateAlias
推送对象

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

请求示例

curl --location --request POST 'http://api.push.mob.com/device-v3/updateAlias' \ 
--header 'key: 2e08782eb311b' \ 
--header 'sign: 5' \ 
--header 'Content-Type: application/json' \ 
--data-raw '{
    "appkey":"2e08782eb311b",
    "registrationId":"65l0soev0d0b4lc",
    "alias":"gxdaoxinsj"
}'

返回示例

请求成功

{
    "status": 200,
    "res": null,
    "error": null
}

请求失败

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

响应参数