> ## Documentation Index > Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt > Use this file to discover all available pages before exploring further. # Kueri informasi perangkat konferensi video > Panggil API ini untuk mengueri informasi dasar perangkat Rapat Video di DingTalk, termasuk status, model, dan detail pengontrol perangkat bagi admin dan pengembang. Panggil API ini untuk mengueri informasi tentang perangkat konferensi video. ## Deskripsi panggilan API Sebelum memanggil API ini, langgani peristiwa [Perubahan pengikatan perangkat-ruang](https://open.dingtalk.com/document/development/org-event-overview#) melalui [Langganan peristiwa](https://open.dingtalk.com/document/development/event-subscription-overview#). ## Permintaan ### Informasi dasar | Bidang | Nilai | | --------------------------- | ---------------------------------------------------------------------------------------- | | URL HTTP | [https://api.dingtalk.io/v1.0/rooms/devices](https://api.dingtalk.io/v1.0/rooms/devices) | | Metode HTTP | GET | | Tipe aplikasi yang didukung | appType-Aplikasi internal | | Izin | permission-VideoConference.Conference.Read-Izin baca untuk informasi konferensi video | ### Header permintaan | Nama | Tipe | Wajib | Deskripsi | | --------------------------- | ------ | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | x-acs-dingtalk-access-token | String | Ya | Kredensial akses untuk memanggil API ini. Untuk mendapatkan nilainya, panggil API [Mendapatkan access token aplikasi internal](/id/open/development/obtain-the-access-token-of-an-internal-app#). | ### Parameter kueri | Nama | Tipe | Wajib | Deskripsi | | --------------- | ------ | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | operatorUnionId | String | Ya | unionId dari operator yang melakukan kueri. Untuk mendapatkan nilainya, panggil API [Kueri detail pengguna](/id/open/development/query-user-details#). | | deviceId | String | Tidak | ID perangkat yang akan dikueri. Dapatkan nilainya dengan melanggani peristiwa [Perubahan pengikatan perangkat-ruang](https://open.dingtalk.com/document/development/org-event-overview#). Tentukan salah satu dari `deviceId` atau `deviceUnionId`. | | deviceUnionId | String | Tidak | unionId dari perangkat yang akan dikueri. Dapatkan nilainya dengan melanggani peristiwa [Perubahan pengikatan perangkat-ruang](https://open.dingtalk.com/document/development/org-event-overview#). Tentukan salah satu dari `deviceId` atau `deviceUnionId`. | ### Contoh permintaan HTTP ```http theme={"theme":{"light":"github-light","dark":"github-dark"}} GET /v1.0/rooms/devices?operatorUnionId=lmvxxxxx&deviceId=1234&deviceUnionId=lmvUxxxxx HTTP/1.1 Host:api.dingtalk.io x-acs-dingtalk-access-token:xxxxx Content-Type:application/json ``` Java ```java theme={"theme":{"light":"github-light","dark":"github-dark"}} // This file is auto-generated, don't edit it. Thanks. package com.aliyun.sample; import com.aliyun.tea.*; public class Sample { /** * Initialize the account client with a token. * @return Client * @throws Exception */ public static com.aliyun.dingtalkrooms_1_0.Client createClient() throws Exception { com.aliyun.teaopenapi.models.Config config = new com.aliyun.teaopenapi.models.Config(); config.protocol = "https"; config.regionId = "central"; return new com.aliyun.dingtalkrooms_1_0.Client(config); } public static void main(String[] args_) throws Exception { java.util.List args = java.util.Arrays.asList(args_); com.aliyun.dingtalkrooms_1_0.Client client = Sample.createClient(); com.aliyun.dingtalkrooms_1_0.models.QueryMeetingRoomDeviceHeaders queryMeetingRoomDeviceHeaders = new com.aliyun.dingtalkrooms_1_0.models.QueryMeetingRoomDeviceHeaders(); queryMeetingRoomDeviceHeaders.xAcsDingtalkAccessToken = ""; com.aliyun.dingtalkrooms_1_0.models.QueryMeetingRoomDeviceRequest queryMeetingRoomDeviceRequest = new com.aliyun.dingtalkrooms_1_0.models.QueryMeetingRoomDeviceRequest() .setOperatorUnionId("lmvxxxxx") .setDeviceId("1234") .setDeviceUnionId("lmvUxxxxx"); try { client.queryMeetingRoomDeviceWithOptions(queryMeetingRoomDeviceRequest, queryMeetingRoomDeviceHeaders, new com.aliyun.teautil.models.RuntimeOptions()); } catch (TeaException err) { if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) { // err contains code and message properties to help diagnose the issue } } catch (Exception _err) { TeaException err = new TeaException(_err.getMessage(), _err); if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) { // err contains code and message properties to help diagnose the issue } } } } ``` Python ```python theme={"theme":{"light":"github-light","dark":"github-dark"}} # -*- coding: utf-8 -*- # This file is auto-generated, don't edit it. Thanks. import os import sys from typing import List from alibabacloud_dingtalk.rooms_1_0.client import Client as dingtalkrooms_1_0Client from alibabacloud_tea_openapi import models as open_api_models from alibabacloud_dingtalk.rooms_1_0 import models as dingtalkrooms__1__0_models from alibabacloud_tea_util import models as util_models from alibabacloud_tea_util.client import Client as UtilClient class Sample: def __init__(self): pass @staticmethod def create_client() -> dingtalkrooms_1_0Client: """ Initialize the account client with a token. @return: Client @throws Exception """ config = open_api_models.Config() config.protocol = 'https' config.region_id = 'central' return dingtalkrooms_1_0Client(config) @staticmethod def main( args: List[str], ) -> None: client = Sample.create_client() query_meeting_room_device_headers = dingtalkrooms__1__0_models.QueryMeetingRoomDeviceHeaders() query_meeting_room_device_headers.x_acs_dingtalk_access_token = '' query_meeting_room_device_request = dingtalkrooms__1__0_models.QueryMeetingRoomDeviceRequest( operator_union_id='lmvxxxxx', device_id='1234', device_union_id='lmvUxxxxx' ) try: client.query_meeting_room_device_with_options(query_meeting_room_device_request, query_meeting_room_device_headers, util_models.RuntimeOptions()) except Exception as err: if not UtilClient.empty(err.code) and not UtilClient.empty(err.message): # err contains code and message properties to help diagnose the issue pass @staticmethod async def main_async( args: List[str], ) -> None: client = Sample.create_client() query_meeting_room_device_headers = dingtalkrooms__1__0_models.QueryMeetingRoomDeviceHeaders() query_meeting_room_device_headers.x_acs_dingtalk_access_token = '' query_meeting_room_device_request = dingtalkrooms__1__0_models.QueryMeetingRoomDeviceRequest( operator_union_id='lmvxxxxx', device_id='1234', device_union_id='lmvUxxxxx' ) try: await client.query_meeting_room_device_with_options_async(query_meeting_room_device_request, query_meeting_room_device_headers, util_models.RuntimeOptions()) except Exception as err: if not UtilClient.empty(err.code) and not UtilClient.empty(err.message): # err contains code and message properties to help diagnose the issue pass if __name__ == '__main__': Sample.main(sys.argv[1:]) ``` PHP ```java theme={"theme":{"light":"github-light","dark":"github-dark"}} protocol = "https"; $config->regionId = "central"; return new Dingtalk($config); } /** * @param string[] $args * @return void */ public static function main($args){ $client = self::createClient(); $queryMeetingRoomDeviceHeaders = new QueryMeetingRoomDeviceHeaders([]); $queryMeetingRoomDeviceHeaders->xAcsDingtalkAccessToken = ""; $queryMeetingRoomDeviceRequest = new QueryMeetingRoomDeviceRequest([ "operatorUnionId" => "lmvxxxxx", "deviceId" => "1234", "deviceUnionId" => "lmvUxxxxx" ]); try { $client->queryMeetingRoomDeviceWithOptions($queryMeetingRoomDeviceRequest, $queryMeetingRoomDeviceHeaders, new RuntimeOptions([])); } catch (Exception $err) { if (!($err instanceof TeaError)) { $err = new TeaError([], $err->getMessage(), $err->getCode(), $err); } if (!Utils::empty_($err->code) && !Utils::empty_($err->message)) { // err contains code and message properties to help diagnose the issue } } } } $path = __DIR__ . \DIRECTORY_SEPARATOR . '..' . \DIRECTORY_SEPARATOR . 'vendor' . \DIRECTORY_SEPARATOR . 'autoload.php'; if (file_exists($path)) { require_once $path; } Sample::main(array_slice($argv, 1)); ``` Go ```go theme={"theme":{"light":"github-light","dark":"github-dark"}} // This file is auto-generated, don't edit it. Thanks. package main import ( "os" util "github.com/alibabacloud-go/tea-utils/v2/service" dingtalkrooms_1_0 "github.com/alibabacloud-go/dingtalk/rooms_1_0" openapi "github.com/alibabacloud-go/darabonba-openapi/v2/client" "github.com/alibabacloud-go/tea/tea" ) /** * Initialize the account client with a token. * @return Client * @throws Exception */ func CreateClient () (_result *dingtalkrooms_1_0.Client, _err error) { config := &openapi.Config{} config.Protocol = tea.String("https") config.RegionId = tea.String("central") _result = &dingtalkrooms_1_0.Client{} _result, _err = dingtalkrooms_1_0.NewClient(config) return _result, _err } func _main (args []*string) (_err error) { client, _err := CreateClient() if _err != nil { return _err } queryMeetingRoomDeviceHeaders := &dingtalkrooms_1_0.QueryMeetingRoomDeviceHeaders{} queryMeetingRoomDeviceHeaders.XAcsDingtalkAccessToken = tea.String("") queryMeetingRoomDeviceRequest := &dingtalkrooms_1_0.QueryMeetingRoomDeviceRequest{ OperatorUnionId: tea.String("lmvxxxxx"), DeviceId: tea.String("1234"), DeviceUnionId: tea.String("lmvUxxxxx"), } tryErr := func()(_e error) { defer func() { if r := tea.Recover(recover()); r != nil { _e = r } }() _, _err = client.QueryMeetingRoomDeviceWithOptions(queryMeetingRoomDeviceRequest, queryMeetingRoomDeviceHeaders, &util.RuntimeOptions{}) if _err != nil { return _err } return nil }() if tryErr != nil { var err = &tea.SDKError{} if _t, ok := tryErr.(*tea.SDKError); ok { err = _t } else { err.Message = tea.String(tryErr.Error()) } if !tea.BoolValue(util.Empty(err.Code)) && !tea.BoolValue(util.Empty(err.Message)) { // err contains code and message properties to help diagnose the issue } } return _err } func main() { err := _main(tea.StringSlice(os.Args[1:])) if err != nil { panic(err) } } ``` Node.js ```python theme={"theme":{"light":"github-light","dark":"github-dark"}} // This file is auto-generated, don't edit it import Util, * as $Util from '@alicloud/tea-util'; import dingtalkrooms_1_0, * as $dingtalkrooms_1_0 from '@alicloud/dingtalk/rooms_1_0'; import OpenApi, * as $OpenApi from '@alicloud/openapi-client'; import * as $tea from '@alicloud/tea-typescript'; export default class Client { /** * Initialize the account client with a token. * @return Client * @throws Exception */ static createClient(): dingtalkrooms_1_0 { let config = new $OpenApi.Config({ }); config.protocol = "https"; config.regionId = "central"; return new dingtalkrooms_1_0(config); } static async main(args: string[]): Promise { let client = Client.createClient(); let queryMeetingRoomDeviceHeaders = new $dingtalkrooms_1_0.QueryMeetingRoomDeviceHeaders({ }); queryMeetingRoomDeviceHeaders.xAcsDingtalkAccessToken = ""; let queryMeetingRoomDeviceRequest = new $dingtalkrooms_1_0.QueryMeetingRoomDeviceRequest({ operatorUnionId: "lmvxxxxx", deviceId: "1234", deviceUnionId: "lmvUxxxxx", }); try { await client.queryMeetingRoomDeviceWithOptions(queryMeetingRoomDeviceRequest, queryMeetingRoomDeviceHeaders, new $Util.RuntimeOptions({ })); } catch (err) { if (!Util.empty(err.code) && !Util.empty(err.message)) { // err contains code and message properties to help diagnose the issue } } } } Client.main(process.argv.slice(2)); ``` C# ```java theme={"theme":{"light":"github-light","dark":"github-dark"}} // This file is auto-generated, don't edit it. Thanks. using System; using System.Collections; using System.Collections.Generic; using System.IO; using System.Threading.Tasks; using Tea; using Tea.Utils; namespace AlibabaCloud.SDK.Sample { public class Sample { /** * Initialize the account client with a token. * @return Client * @throws Exception */ public static AlibabaCloud.SDK.Dingtalkrooms_1_0.Client CreateClient() { AlibabaCloud.OpenApiClient.Models.Config config = new AlibabaCloud.OpenApiClient.Models.Config(); config.Protocol = "https"; config.RegionId = "central"; return new AlibabaCloud.SDK.Dingtalkrooms_1_0.Client(config); } public static void Main(string[] args) { AlibabaCloud.SDK.Dingtalkrooms_1_0.Client client = CreateClient(); AlibabaCloud.SDK.Dingtalkrooms_1_0.Models.QueryMeetingRoomDeviceHeaders queryMeetingRoomDeviceHeaders = new AlibabaCloud.SDK.Dingtalkrooms_1_0.Models.QueryMeetingRoomDeviceHeaders(); queryMeetingRoomDeviceHeaders.XAcsDingtalkAccessToken = ""; AlibabaCloud.SDK.Dingtalkrooms_1_0.Models.QueryMeetingRoomDeviceRequest queryMeetingRoomDeviceRequest = new AlibabaCloud.SDK.Dingtalkrooms_1_0.Models.QueryMeetingRoomDeviceRequest { OperatorUnionId = "lmvxxxxx", DeviceId = "1234", DeviceUnionId = "lmvUxxxxx", }; try { client.QueryMeetingRoomDeviceWithOptions(queryMeetingRoomDeviceRequest, queryMeetingRoomDeviceHeaders, new AlibabaCloud.TeaUtil.Models.RuntimeOptions()); } catch (TeaException err) { if (!AlibabaCloud.TeaUtil.Common.Empty(err.Code) && !AlibabaCloud.TeaUtil.Common.Empty(err.Message)) { // err contains code and message properties to help diagnose the issue } } catch (Exception _err) { TeaException err = new TeaException(new Dictionary { { "message", _err.Message } }); if (!AlibabaCloud.TeaUtil.Common.Empty(err.Code) && !AlibabaCloud.TeaUtil.Common.Empty(err.Message)) { // err contains code and message properties to help diagnose the issue } } } } } ``` ## Respons ### Isi respons | Nama | Tipe | Deskripsi | | --------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | result | Object | Hasil respons. | | deviceId | String | ID perangkat. | | deviceUnionId | String | unionId perangkat. | | openRoomId | String | ID ruang yang terikat pada perangkat. | | corpId | String | ID organisasi. | | deviceName | String | Nama perangkat. | | shareCode | String | Kode transmisi perangkat. | | deviceSn | String | Nomor seri perangkat. | | deviceMac | String | Alamat MAC perangkat. | | deviceType | String | Tipe perangkat. - touyingyi: Perangkat Rapat Video - meetingaccessory: Pengontrol perangkat | | deviceServiceId | Integer | ID layanan yang ditetapkan saat perangkat didaftarkan. | | deviceModel | String | Model perangkat. | | deviceStatus | String | Status perangkat. - idle: Senggang - projection: Sedang mentransmisikan - conf\_incoming: Rapat berdering - conf\_running: Dalam Rapat - white\_board: Sedang menggunakan Whiteboard - offline: Offline | | controllers | Array | Daftar pengontrol perangkat. | | deviceId | String | ID perangkat pengontrol. | | deviceUnionId | String | unionId pengontrol perangkat. | | openRoomId | String | ID ruang yang terikat pada pengontrol perangkat. | | corpId | String | ID organisasi. | | shareCode | String | Kode transmisi pengontrol perangkat. | | deviceSn | String | Nomor seri pengontrol perangkat. | | deviceType | String | Tipe perangkat: - touyingyi: Perangkat Rapat Video - meetingaccessory: Pengontrol perangkat | | deviceServiceId | Integer | ID layanan yang ditetapkan saat pengontrol perangkat didaftarkan. | | deviceModel | String | Model pengontrol perangkat. | | deviceName | String | Nama pengontrol perangkat. | | deviceStatus | String | Status pengontrol perangkat. - idle: Senggang - projection: Sedang mentransmisikan - conf\_incoming: Rapat berdering - conf\_running: Dalam Rapat - white\_board: Sedang menggunakan Whiteboard - offline: Offline | | deviceMac | String | Alamat MAC pengontrol perangkat. | | creatorUnionId | String | Operator yang membuat perangkat. | | roomName | String | Nama ruang tempat perangkat berada. | | firmwareVersion | String | Versi firmware perangkat. | | softwareVersion | String | Versi perangkat lunak perangkat. | | activeTime | Long | Waktu aktivasi perangkat. | | devNetType | String | Tipe jaringan perangkat. | | devNetIp | String | Alamat IP perangkat. | | devWifiMac | String | Alamat MAC nirkabel perangkat. | | devWireMac | String | Alamat MAC kabel perangkat. | | devCamera | String | Model kamera. | | devMic | String | Model mikrofon. | | devVoice | String | Model speaker. | | devMirror | String | Status mirroring. | | devHdmi | String | Status output HDMI. | | sipAccountName | String | Akun SIP. | ### Contoh isi respons ```text theme={"theme":{"light":"github-light","dark":"github-dark"}} HTTP/1.1 200 OK Content-Type:application/json { "result" : { "deviceId" : "1234", "deviceUnionId" : "lmvUxxxxx", "openRoomId" : "7263xxxxx", "corpId" : "ding99xxxxx", "deviceName" : "Perangkat Rapat DingTalk_xxxx", "shareCode" : "123456", "deviceSn" : "02caxxxxx", "deviceMac" : "14:85:7f:xx:xx:xx", "deviceType" : "touyingyi", "deviceServiceId" : 1204, "deviceModel" : "winbox", "deviceStatus" : "offline", "controllers" : [ { "deviceId" : "2345", "deviceUnionId" : "lmvUxxxxx", "openRoomId" : "7263xxxxx", "corpId" : "ding99xxxxx", "shareCode" : "234567", "deviceSn" : "02caxxxxx", "deviceType" : "touyingyi", "deviceServiceId" : 1190, "deviceModel" : "AILABS_S3_T1", "deviceName" : "Tablet Kontrol Rapat_xxxx", "deviceStatus" : "white_board", "deviceMac" : "d8:2f:e6:xx:xx:xx" } ], "creatorUnionId" : "lPHhSZDLXXXXXXpBlC9lxLwiEiE", "roomName" : "Ruang Rapat Uji", "firmwareVersion" : "LMVXXX.20XX0818", "softwareVersion" : "7.14.1", "activeTime" : 1697198045000, "devNetType" : "net_wired", "devNetIp" : "127.0.0.10", "devWifiMac" : "d4:aa:ee:e8:4d:55", "devWireMac" : "d4:3a:ee:aa:45:85", "devCamera" : "Kamera Cerdas", "devMic" : "Mikrofon (2- Built-in Audio)", "devVoice" : "Speaker (2- Built-in Audio)", "devMirror" : "false", "devHdmi" : "false", "sipAccountName" : "sip13492" } } ``` ### Kode error Jika terjadi error saat memanggil API ini, cari solusinya berdasarkan pesan error di dokumen [Kode error global](/id/open/development/server-api-error-codes-1). | HttpCode | Kode error | Pesan error | Deskripsi | | -------- | ---------------- | ---------------- | --------------------------------- | | 400 | device.not.found | device not found | Perangkat tidak ada. | | 400 | param.error | param error | Parameter operatorUnionId kosong. | | 403 | no.permission | no permission | Tidak ada izin kueri. | | 500 | system.error | system error | Error sistem. |