设备信息

设备信息查询

根据用户 ID 或设备 ID 获取设备信息,包含设备绑定信息、设备关联的厂商信息、安卓系统设备是否在线等。

入参

参数

类型

是否必选

示例

描述

appId

String

ONEX570DA89211721

应用 ID

workspaceId

String

default

工作空间 ID

tenantId

String

LZFPEFIM

租户 ID

targetType

Integer

2

目标类型:

  • 1 - 设备

  • 2 - 用户

target

String

push_test_user

  • 当 targetType=1 时,target 是设备 ID

  • 当 targetType=2 时,target 是用户 ID

出参

参数

类型

示例

描述

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

平台:

  • android

  • ios

  • harmonyos

manufacturer

String

hms

厂商:

  • unknown

  • android

  • ios

  • miui

  • hms

  • fcm

  • oppo

  • vivo

  • honor

  • harmonyos

statue

String

ONLINE

状态(iOS 和鸿蒙系统默认 UNKNOW)

  • ONLINE

  • OFFLINE

  • UNKNOW

使用示例

public static String PRODUCT = "mpaas";
public static String REGION_ID = "cn-hangzhou";
public static String ENDPOINT = "mpaas.cn-hangzhou.aliyuncs.com";
public static String ACCESS_KEY_ID = "LTAI5tMZRxxx";
public static String ACCESS_KEY_SECRET = "C811bjRcxxx";

public static void main(String[] args) throws Exception {
    DefaultProfile.addEndpoint(REGION_ID, PRODUCT, ENDPOINT);
    DefaultProfile profile = DefaultProfile.getProfile(
            REGION_ID,          // 地域ID
            ACCESS_KEY_ID,      // RAM账号的AccessKey ID
            ACCESS_KEY_SECRET); // RAM账号AccessKey Secret
    IAcsClient client = new DefaultAcsClient(profile);
    PushQueryDeviceStateRequest request = new PushQueryDeviceStateRequest();
    request.setAppId("570DA8928xx");
    request.setWorkspaceId("default");
    request.setTenantId("ALIYUNTEST");
    request.setTargetType(2);
    request.setTarget("push_test");
    PushQueryDeviceStateResponse response = client.getAcsResponse(request);
    System.out.println("response==>"+JSON.toJSONString(response));
}

结果码

结果码

结果信息

描述

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

系统异常