设备信息查询
根据用户 ID 或设备 ID 获取设备信息,包含设备绑定信息、设备关联的厂商信息、安卓系统设备是否在线等。
入参
参数 | 类型 | 是否必选 | 示例 | 描述 |
appId | String | 是 | ONEX570DA89211721 | 应用 ID |
workspaceId | String | 是 | default | 工作空间 ID |
tenantId | String | 是 | LZFPEFIM | 租户 ID |
targetType | Integer | 是 | 2 | 目标类型:
|
target | String | 是 | push_test_user |
|
出参
参数 | 类型 | 示例 | 描述 |
requestId | String | 6FF637EA-D55D-1A4E-8443-DF28688E61B8 | 请求 ID |
success | Boolean | true | 结果 |
code | String | 100 | 结果码 |
message | String | SUCCESS | 结果信息 |
data | Object | - | 结果内容 |
data | |||
参数 | 类型 | 示例 | 描述 |
userId | String | push_test_user | 用户 ID |
deviceId | String | ae6f2a800196100080003030ac10010a396 | 设备 ID |
deliveryToken | String | ae6f2a800196100080003030ac10010a396 | 自建 Token |
thirdToken | String | IQAAAACy0f7tAABYiMwLEENtr0TKYJEsv7wyu4Ubt9XXwTJAlknnCb1LAzB3wJvoZIcT_nJdaMhEoXJaqQrObAGHLGoU1GOexlTcLWzja-0HfGHKBw | 厂商 Token |
platform | String | android | 平台:
|
manufacturer | String | hms | 厂商:
|
statue | String | ONLINE | 状态(iOS 和鸿蒙系统默认 UNKNOW)
|
使用示例
import com.alibaba.fastjson.JSON;
import com.aliyun.mpaas20201028.Client;
import com.aliyun.mpaas20201028.models.PushQueryDeviceStateRequest;
import com.aliyun.mpaas20201028.models.PushQueryDeviceStateResponse;
import com.aliyun.teaopenapi.models.Config;
public static void main(String[] args) throws Exception {
// 阿里云账号AccessKey拥有所有API的访问权限,建议您使用RAM用户进行API访问或日常运维。
// 强烈建议不要把AccessKey ID和AccessKey Secret保存到工程代码里,否则可能导致AccessKey泄露,威胁您账号下所有资源的安全。
// 本示例以将AccessKey ID和AccessKey Secret保存在环境变量为例说明。您也可以根据业务需要,保存到配置文件里。
// 建议先完成环境变量配置
Config config = new Config();
// 必填,您的 AccessKey ID
config.setAccessKeyId(System.getenv("MPAAS_AK_ENV"));
// 必填,您的 AccessKey Secret
config.setAccessKeySecret(System.getenv("MPAAS_SK_ENV"));
// mPaaS 的 REGION_ID 和 Endpoint,以杭州非金为例
config.setRegionId("cn-hangzhou");
config.setEndpoint("mpaas.cn-hangzhou.aliyuncs.com");
Client client = new Client(config);
PushQueryDeviceStateRequest request = new PushQueryDeviceStateRequest();
request.setAppId("ONEX570DA89211721");
request.setWorkspaceId("test");
request.setTenantId("xxx");
request.setTargetType(2);
request.setTarget("push_test");
PushQueryDeviceStateResponse pushQueryDeviceStateResponse = client.pushQueryDeviceState(request);
System.out.println("response==>"+ JSON.toJSONString(pushQueryDeviceStateResponse));
}结果码
结果码 | 结果信息 | 描述 |
100 | SUCCESS | 成功 |
3028 | INVALID_PARAM | 请检查一下参数 |
8011 | FLOW_CONTROL_ERROR | 流量控制 |
8012 | INVALID_INSTANCE_ID | 请检查一下 appId 和 workspaceId |
8013 | INVALID_TENANT_ID | 非法 tenantId |
8014 | ACCOUNT_NO_PERMISSION | no permission |
9000 | SYSTEM_ERROR | 系统异常 |