调用验证

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

频率控制

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

查询设备信息

根据 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": "数据校验失败" }响应参数