> ## 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. # Membuat rapat video > Panggil API ini untuk membuat rapat video dengan judul kustom dan partisipan yang diundang, lengkap dengan parameter permintaan dan referensi bidang respons. Panggil API ini untuk membuat rapat video. Pengguna dapat menyesuaikan topik rapat dan mengundang partisipan. ## Permintaan ### Informasi dasar | Bidang | Nilai | | --------------------------- | -------------------------------------------------------------------------------------------------------------------- | | URL HTTP | [https://api.dingtalk.io/v1.0/conference/videoConferences](https://api.dingtalk.io/v1.0/conference/videoConferences) | | Metode HTTP | POST | | Tipe aplikasi yang didukung | appType-Aplikasi internal　appType-Aplikasi perusahaan pihak ketiga | | Izin yang diperlukan | permission-VideoConference.Conference.Write-Izin pengelolaan informasi Rapat Video | ### Header permintaan | Nama | Tipe | Wajib | Deskripsi | | --------------------------- | ------ | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | x-acs-dingtalk-access-token | String | Ya | Kredensial akses yang digunakan untuk memanggil API ini. Dapatkan dengan cara berikut: - Untuk aplikasi internal, panggil API [Mendapatkan access token aplikasi internal](/id/open/development/obtain-the-access-token-of-an-internal-app#). - Untuk aplikasi perusahaan pihak ketiga, panggil API [Mendapatkan access token perusahaan yang diberi otorisasi ke aplikasi pihak ketiga](https://open.dingtalk.com/document/development/obtain-the-access-token-of-the-authorized-enterprise-1#). | ### Isi permintaan | Nama | Tipe | Wajib | Deskripsi | | ------------- | --------------- | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | userId | String | Ya | unionId dari penyelenggara rapat. Panggil API [Melihat detail pengguna](/id/open/development/query-user-details#) untuk mendapatkannya. | | confTitle | String | Ya | Judul rapat yang dipesan. Judul tidak boleh melebihi 50 karakter. Judul yang lebih dari 50 karakter akan dipotong. Judul yang lebih dari 256 karakter menyebabkan panggilan API gagal. | | inviteUserIds | Array of String | Tidak | Daftar unionId partisipan yang akan diundang. Panggil API [Melihat detail pengguna](/id/open/development/query-user-details#) untuk mendapatkannya. Undangan harus merupakan rekan kerja dalam organisasi yang sama dengan penyelenggara rapat. | | inviteCaller | Boolean | Tidak | Apakah mengundang pemanggil. - true: Undang. Ini adalah nilai default. - false: Jangan undang. | ### Contoh permintaan HTTP ```http theme={"theme":{"light":"github-light","dark":"github-dark"}} POST /v1.0/conference/videoConferences HTTP/1.1 Host:api.dingtalk.io x-acs-dingtalk-access-token:e6bba9c0d0343fcfaec87944fe37061D Content-Type:application/json { "userId" : "27SaQ3iiHLN0uwqcPisedfreNwiEiE", "confTitle" : "Rapat video milik XXX", "inviteUserIds" : [ "iSKzJxxxxx" ], "inviteCaller" : false } ``` 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.CreateVideoConferenceHeaders createVideoConferenceHeaders = new com.aliyun.dingtalkconference_1_0.models.CreateVideoConferenceHeaders(); createVideoConferenceHeaders.xAcsDingtalkAccessToken = ""; com.aliyun.dingtalkconference_1_0.models.CreateVideoConferenceRequest createVideoConferenceRequest = new com.aliyun.dingtalkconference_1_0.models.CreateVideoConferenceRequest() .setUserId("27SaQ3iiHLN0uwqcPisedfreNwiEiE") .setConfTitle("Rapat video milik XXX") .setInviteUserIds(java.util.Arrays.asList( "iSKzJxxxxx" )) .setInviteCaller(false); try { client.createVideoConferenceWithOptions(createVideoConferenceRequest, createVideoConferenceHeaders, 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 to 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 to 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() create_video_conference_headers = dingtalkconference__1__0_models.CreateVideoConferenceHeaders() create_video_conference_headers.x_acs_dingtalk_access_token = '' create_video_conference_request = dingtalkconference__1__0_models.CreateVideoConferenceRequest( user_id='27SaQ3iiHLN0uwqcPisedfreNwiEiE', conf_title="Rapat video milik XXX", invite_user_ids=[ 'iSKzJxxxxx' ], invite_caller=False ) try: client.create_video_conference_with_options(create_video_conference_request, create_video_conference_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 to help locate the issue pass @staticmethod async def main_async( args: List[str], ) -> None: client = Sample.create_client() create_video_conference_headers = dingtalkconference__1__0_models.CreateVideoConferenceHeaders() create_video_conference_headers.x_acs_dingtalk_access_token = '' create_video_conference_request = dingtalkconference__1__0_models.CreateVideoConferenceRequest( user_id='27SaQ3iiHLN0uwqcPisedfreNwiEiE', conf_title="Rapat video milik XXX", invite_user_ids=[ 'iSKzJxxxxx' ], invite_caller=False ) try: await client.create_video_conference_with_options_async(create_video_conference_request, create_video_conference_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 to 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(); $createVideoConferenceHeaders = new CreateVideoConferenceHeaders([]); $createVideoConferenceHeaders->xAcsDingtalkAccessToken = ""; $createVideoConferenceRequest = new CreateVideoConferenceRequest([ "userId" => "27SaQ3iiHLN0uwqcPisedfreNwiEiE", "confTitle" => "Rapat video milik XXX", "inviteUserIds" => [ "iSKzJxxxxx" ], "inviteCaller" => false ]); try { $client->createVideoConferenceWithOptions($createVideoConferenceRequest, $createVideoConferenceHeaders, 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 to 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/service" dingtalkconference_1_0 "github.com/alibabacloud-go/dingtalk/conference_1_0" openapi "github.com/alibabacloud-go/darabonba-openapi/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 } createVideoConferenceHeaders := &dingtalkconference_1_0.CreateVideoConferenceHeaders{} createVideoConferenceHeaders.XAcsDingtalkAccessToken = tea.String("") createVideoConferenceRequest := &dingtalkconference_1_0.CreateVideoConferenceRequest{ UserId: tea.String("27SaQ3iiHLN0uwqcPisedfreNwiEiE"), ConfTitle: tea.String("Rapat video milik XXX"), InviteUserIds: []*string{tea.String("iSKzJxxxxx")}, InviteCaller: tea.Bool(false), } tryErr := func()(_e error) { defer func() { if r := tea.Recover(recover()); r != nil { _e = r } }() _, _err = client.CreateVideoConferenceWithOptions(createVideoConferenceRequest, createVideoConferenceHeaders, &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 to 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 createVideoConferenceHeaders = new $dingtalkconference_1_0.CreateVideoConferenceHeaders({ }); createVideoConferenceHeaders.xAcsDingtalkAccessToken = ""; let createVideoConferenceRequest = new $dingtalkconference_1_0.CreateVideoConferenceRequest({ userId: "27SaQ3iiHLN0uwqcPisedfreNwiEiE", confTitle: "Rapat video milik XXX", inviteUserIds: [ "iSKzJxxxxx" ], inviteCaller: false, }); try { await client.createVideoConferenceWithOptions(createVideoConferenceRequest, createVideoConferenceHeaders, new $Util.RuntimeOptions({ })); } catch (err) { if (!Util.empty(err.code) && !Util.empty(err.message)) { // err contains code and message attributes to 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.CreateVideoConferenceHeaders createVideoConferenceHeaders = new AlibabaCloud.SDK.Dingtalkconference_1_0.Models.CreateVideoConferenceHeaders(); createVideoConferenceHeaders.XAcsDingtalkAccessToken = ""; AlibabaCloud.SDK.Dingtalkconference_1_0.Models.CreateVideoConferenceRequest createVideoConferenceRequest = new AlibabaCloud.SDK.Dingtalkconference_1_0.Models.CreateVideoConferenceRequest { UserId = "27SaQ3iiHLN0uwqcPisedfreNwiEiE", ConfTitle = "Rapat video milik XXX", InviteUserIds = new List { "iSKzJxxxxx" }, InviteCaller = false, }; try { client.CreateVideoConferenceWithOptions(createVideoConferenceRequest, createVideoConferenceHeaders, 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 to 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 to help locate the issue } } } } } ``` ## Respons ### Isi respons | Nama | Tipe | Deskripsi | | ------------------ | --------------- | ---------------------------------- | | conferenceId | String | ID rapat. | | conferencePassword | String | Kode Rapat. | | hostPassword | String | Kata sandi tuan rumah. | | externalLinkUrl | String | Tautan untuk Gabung ke konferensi. | | phoneNumbers | Array of String | Nomor dial-in PSTN. | | roomCode | String | Kode rapat. | ### Contoh isi respons ```text theme={"theme":{"light":"github-light","dark":"github-dark"}} HTTP/1.1 200 OK Content-Type:application/json { "conferenceId" : "607452e01401526ee39609e1", "conferencePassword" : "1151302294", "hostPassword" : "2142817614", "externalLinkUrl" : "https://pre-meeting.dingtalk.io/app?roomCode=68550708396&token=1_59209c43-431c-4e57-a0f8-11bebdb3db7f", "phoneNumbers" : [ "0571-26883112" ], "roomCode" : "123" } ``` ### Kode error Jika terjadi error saat Anda memanggil API ini, cari solusinya di dokumen [Kode error global](/id/open/development/server-api-error-codes-1) berdasarkan pesan error. | HttpCode | Kode error | Pesan error | Deskripsi | | -------- | ------------------ | ------------------ | -------------------------------------- | | 400 | orgAccessForbidden | orgAccessForbidden | Akses organisasi dibatasi. | | 400 | unknownUserError | unknownUserError | Pengguna tidak dikenali. | | 400 | paramsTitleError | error:%s | Judul rapat tidak valid. | | 400 | paramsError | error:%s | Error parameter. | | 404 | waterLimitError | waterLimitError:%s | Batas laju jumlah partisipan tercapai. | | 404 | permissionError | permissionError:%s | Izin grup dibatasi. | | 500 | systemError | systemError:%s | Error sistem. |