> ## 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 rapat video > Panggil API ini untuk mengkueri informasi dasar rapat video di DingTalk, termasuk nama rapat, durasi, waktu mulai, waktu berakhir, serta total jumlah peserta. Panggil API ini untuk mengambil informasi dasar sebuah rapat, termasuk nama rapat, durasi, waktu mulai, waktu berakhir, dan total jumlah peserta. ## Permintaan ### Informasi dasar | Bidang | Nilai | | --------------------------- | -------------------------------------------------------------------------------- | | URL HTTP | `https://api.dingtalk.io/v1.0/conference/videoConferences/{conferenceId}` | | Metode HTTP | GET | | Tipe aplikasi yang didukung | appType-Internal app　appType-Third-party enterprise app | | Izin yang diperlukan | permission-VideoConference.Conference.Read-Izin baca untuk informasi rapat video | ### Header permintaan | Nama | Tipe | Wajib | Deskripsi | | --------------------------- | ------ | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | x-acs-dingtalk-access-token | String | Ya | Kredensial akses untuk memanggil API ini. Dapatkan sebagai berikut: - Untuk aplikasi internal, panggil API [Dapatkan access token aplikasi internal](/id/open/development/obtain-the-access-token-of-an-internal-app#). - Untuk aplikasi perusahaan pihak ketiga, panggil API [Dapatkan access token organisasi yang mengotorisasi aplikasi pihak ketiga](https://open.dingtalk.com/document/development/obtain-the-access-token-of-the-authorized-enterprise-1#). | ### Parameter jalur | Nama | Tipe | Wajib | Deskripsi | | ------------ | ------ | ----- | ---------------------------------------------------------------------------------------------------------------------------------------- | | conferenceId | String | Ya | conferenceId dari rapat. Panggil API [Buat rapat video](/id/open/development/create-a-video-conference#) untuk mendapatkan conferenceId. | ### Contoh permintaan HTTP ```http theme={"theme":{"light":"github-light","dark":"github-dark"}} GET /v1.0/conference/videoConferences/6323d7xxxxx 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.dingtalkconference_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.dingtalkconference_1_0.Client(config); } public static void main(String[] args_) throws Exception { java.util.List args = java.util.Arrays.asList(args_); com.aliyun.dingtalkconference_1_0.Client client = Sample.createClient(); com.aliyun.dingtalkconference_1_0.models.QueryConferenceInfoHeaders queryConferenceInfoHeaders = new com.aliyun.dingtalkconference_1_0.models.QueryConferenceInfoHeaders(); queryConferenceInfoHeaders.xAcsDingtalkAccessToken = ""; try { client.queryConferenceInfoWithOptions("6323d7xxxxx", queryConferenceInfoHeaders, 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 attributes that help locate 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 attributes that help locate 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 sys from typing import List from alibabacloud_dingtalk.conference_1_0.client import Client as dingtalkconference_1_0Client from alibabacloud_tea_openapi import models as open_api_models from alibabacloud_dingtalk.conference_1_0 import models as dingtalkconference__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() -> dingtalkconference_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 dingtalkconference_1_0Client(config) @staticmethod def main( args: List[str], ) -> None: client = Sample.create_client() query_conference_info_headers = dingtalkconference__1__0_models.QueryConferenceInfoHeaders() query_conference_info_headers.x_acs_dingtalk_access_token = '' try: client.query_conference_info_with_options('6323d7xxxxx', query_conference_info_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 attributes that help locate the issue pass @staticmethod async def main_async( args: List[str], ) -> None: client = Sample.create_client() query_conference_info_headers = dingtalkconference__1__0_models.QueryConferenceInfoHeaders() query_conference_info_headers.x_acs_dingtalk_access_token = '' try: await client.query_conference_info_with_options_async('6323d7xxxxx', query_conference_info_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 attributes that help locate 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(); $queryConferenceInfoHeaders = new QueryConferenceInfoHeaders([]); $queryConferenceInfoHeaders->xAcsDingtalkAccessToken = ""; try { $client->queryConferenceInfoWithOptions("6323d7xxxxx", $queryConferenceInfoHeaders, 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 attributes that help locate 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" dingtalkconference_1_0 "github.com/alibabacloud-go/dingtalk/conference_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 *dingtalkconference_1_0.Client, _err error) { config := &openapi.Config{} config.Protocol = tea.String("https") config.RegionId = tea.String("central") _result = &dingtalkconference_1_0.Client{} _result, _err = dingtalkconference_1_0.NewClient(config) return _result, _err } func _main (args []*string) (_err error) { client, _err := CreateClient() if _err != nil { return _err } queryConferenceInfoHeaders := &dingtalkconference_1_0.QueryConferenceInfoHeaders{} queryConferenceInfoHeaders.XAcsDingtalkAccessToken = tea.String("") tryErr := func()(_e error) { defer func() { if r := tea.Recover(recover()); r != nil { _e = r } }() _, _err = client.QueryConferenceInfoWithOptions(tea.String("6323d7xxxxx"), queryConferenceInfoHeaders, &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 attributes that help locate 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 dingtalkconference_1_0, * as $dingtalkconference_1_0 from '@alicloud/dingtalk/conference_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(): dingtalkconference_1_0 { let config = new $OpenApi.Config({ }); config.protocol = "https"; config.regionId = "central"; return new dingtalkconference_1_0(config); } static async main(args: string[]): Promise { let client = Client.createClient(); let queryConferenceInfoHeaders = new $dingtalkconference_1_0.QueryConferenceInfoHeaders({ }); queryConferenceInfoHeaders.xAcsDingtalkAccessToken = ""; try { await client.queryConferenceInfoWithOptions("6323d7xxxxx", queryConferenceInfoHeaders, new $Util.RuntimeOptions({ })); } catch (err) { if (!Util.empty(err.code) && !Util.empty(err.message)) { // err contains code and message attributes that help locate 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.Dingtalkconference_1_0.Client CreateClient() { AlibabaCloud.OpenApiClient.Models.Config config = new AlibabaCloud.OpenApiClient.Models.Config(); config.Protocol = "https"; config.RegionId = "central"; return new AlibabaCloud.SDK.Dingtalkconference_1_0.Client(config); } public static void Main(string[] args) { AlibabaCloud.SDK.Dingtalkconference_1_0.Client client = CreateClient(); AlibabaCloud.SDK.Dingtalkconference_1_0.Models.QueryConferenceInfoHeaders queryConferenceInfoHeaders = new AlibabaCloud.SDK.Dingtalkconference_1_0.Models.QueryConferenceInfoHeaders(); queryConferenceInfoHeaders.XAcsDingtalkAccessToken = ""; try { client.QueryConferenceInfoWithOptions("6323d7xxxxx", queryConferenceInfoHeaders, 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 attributes that help locate 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 attributes that help locate the issue } } } } } ``` ## Respons ### Isi respons | Nama | Tipe | Deskripsi | | ----------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | confInfo | Object | Informasi rapat. | | activeNum | Integer | Jumlah peserta yang saat ini berada dalam rapat. | | attendNum | Integer | Total jumlah peserta yang bergabung ke rapat. | | confDuration | Long | Durasi rapat, dalam milidetik. Bidang ini dikembalikan setelah rapat berakhir. | | conferenceId | String | ID rapat. | | creatorId | String | unionId pengguna yang membuat rapat. | | creatorNick | String | Nama pengguna yang membuat rapat. | | externalLinkUrl | String | Tautan untuk bergabung ke rapat. | | invitedNum | Integer | Jumlah orang yang diundang. | | startTime | Long | Stempel waktu mulai rapat, dalam milidetik. | | status | Integer | Status rapat. - 0: Diinisialisasi - 1: Rapat berakhir - 2: Rapat dimulai | | title | String | Judul rapat. | | roomCode | String | Kode rapat. | | endTime | Long | Stempel waktu berakhir rapat, dalam milidetik. Bidang ini dikembalikan setelah rapat berakhir. | | scheduleConferenceId | String | ID rapat yang telah dijadwalkan. | | bizType | String | Tipe bisnis rapat: - **0**: Rapat video instan - **3**: Rapat terjadwal - **audio\_conf**: Rapat audio | | cloudRecordStatus | Integer | Status perekaman cloud rapat: - **0**: Tidak merekam - **1**: Sedang merekam - **2**: Perekaman dijeda - **3**: Perekaman berakhir | | cloudRecordOwnerUnionId | String | unionId pemilik perekaman cloud. | | minutesStatus | Integer | Status Notulen Rapat: - **0**: Belum dimulai - **1**: Sedang merekam - **2**: Dijeda - **3**: Berakhir Kemampuan Notulen dalam rapat telah dimigrasikan, dan bidang ini tidak lagi dikembalikan. | | minutesOwnerUnionId | String | unionId pemilik Notulen. Kemampuan Notulen dalam rapat telah dimigrasikan, dan bidang ini tidak lagi dikembalikan. | | extensionAppSettings | Array | Daftar informasi kustom untuk aplikasi ekstensi tingkat rapat. | | appId | String | Agent ID aplikasi mikro tempat cool app rapat berada. | | appCode | String | appCode dari cool app. | | autoOpenMode | Integer | Mode buka otomatis: - **0**: Tidak membuka otomatis - **1**: Membuka otomatis hanya untuk tuan rumah dan co-host - **2**: Membuka otomatis untuk semua peserta | | extensionAppBizData | String | Informasi kustom untuk aplikasi ekstensi tingkat rapat. | ### Contoh isi respons ```text theme={"theme":{"light":"github-light","dark":"github-dark"}} HTTP/1.1 200 OK Content-Type:application/json { "confInfo" : { "activeNum" : 10, "attendNum" : 15, "confDuration" : 1000000, "conferenceId" : "6323dxxxxx", "creatorId" : "2iPOLxxxxx", "creatorNick" : "Xiao Ding", "externalLinkUrl" : "https://meeting.dingtalk.io/app?roomCode=42726xxx&token=1_7ac9xxx", "invitedNum" : 20, "startTime" : 1664175001000, "status" : 1, "title" : "Judul", "roomCode" : "4272xxxxx", "endTime" : 1663294270000, "scheduleConferenceId" : "4331d******", "bizType" : "0", "cloudRecordStatus" : 0, "cloudRecordOwnerUnionId" : "A***EiE", "minutesStatus" : 0, "minutesOwnerUnionId" : "A***EiE", "extensionAppSettings" : [ { "appId" : "29****", "appCode" : "Coo*****", "autoOpenMode" : 0, "extensionAppBizData" : "****" } ] } } ``` ### Kode error Jika terjadi error saat memanggil API ini, lihat dokumen [Kode error global](/id/open/development/server-api-error-codes-1) untuk solusi berdasarkan pesan error. | HttpCode | Kode error | Pesan error | Deskripsi | | -------- | ------------- | --------------- | ------------------------------------- | | 400 | missingRoomId | MISSING ROOM ID | Parameter ID rapat tidak ada. | | 400 | paramError | PARAM ERROR | Error parameter. | | 403 | noPermission | NO PERMISSION | Tidak ada izin untuk mengkueri rapat. | | 404 | roomNotFound | ROOM NOT FOUND | Rapat tidak dapat ditemukan. | | 500 | systemError | SYSTEM ERROR | Error sistem internal. |