> ## 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. # Mendapatkan Knowledge Base > Panggil API ini melalui permintaan GET untuk mendapatkan informasi Knowledge Base di DingTalk, termasuk nama, tipe, ikon, pembuat, izin, dan detail terkait lainnya. Digunakan untuk mendapatkan Knowledge Base. Gunakan permintaan GET. ## Permintaan ### Informasi dasar | Bidang | Nilai | | --------------------------- | ------------------------------------------------------------- | | URL HTTP | `https://api.dingtalk.io/v2.0/wiki/workspaces/{workspaceId}` | | Metode HTTP | GET | | Tipe aplikasi yang didukung | appType-Internal app　appType-Third-party enterprise app | | Izin yang diperlukan | permission-Wiki.Workspace.Read-Knowledge Base read permission | ### Header permintaan | Nama | Tipe | Wajib | Deskripsi | | --------------------------- | ------ | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | x-acs-dingtalk-access-token | String | Ya | Kredensial akses untuk memanggil API ini. - Untuk aplikasi internal, panggil API [Mendapatkan access token aplikasi internal](https://open.dingtalk.com/document/orgapp/obtain-the-access_token-of-an-internal-app) untuk memperolehnya. - Untuk aplikasi perusahaan pihak ketiga, panggil API [Mendapatkan access token organisasi yang diberi otorisasi untuk aplikasi pihak ketiga](https://open.dingtalk.com/document/isvapp/obtain-the-access_token-of-the-authorized-enterprise) untuk memperolehnya. | ### Parameter path | Nama | Tipe | Wajib | Deskripsi | | ----------- | ------ | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | workspaceId | String | Ya | ID Knowledge Base: - Untuk aplikasi internal, panggil API [Mendapatkan daftar Knowledge Base](/id/open/development/get-knowledge-base-list) untuk memperoleh bidang `workspaceId` dalam respons. - Untuk aplikasi perusahaan pihak ketiga, panggil API [Mendapatkan daftar Knowledge Base](/id/open/development/get-knowledge-base-list) untuk memperoleh bidang `workspaceId` dalam respons. | ### Parameter query | Nama | Tipe | Wajib | Deskripsi | | ------------------ | ------- | ----- | --------------------------------------------------------------------------------------------- | | withPermissionRole | Boolean | Tidak | Apakah akan mengambil informasi izin: - true: ambil - false: jangan ambil Default: false. | | operatorId | String | Ya | unionId dari operator. | ### Contoh permintaan HTTP ```http theme={"theme":{"light":"github-light","dark":"github-dark"}} GET /v2.0/wiki/workspaces/MJ0pDSKMV9dO20E4?withPermissionRole=false&operatorId=tXguN309iPhE4roSKPlLURAiEiE HTTP/1.1 Host:api.dingtalk.io x-acs-dingtalk-access-token:access_token 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 using the Token * @return Client * @throws Exception */ public static com.aliyun.dingtalkwiki_2_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.dingtalkwiki_2_0.Client(config); } public static void main(String[] args_) throws Exception { java.util.List args = java.util.Arrays.asList(args_); com.aliyun.dingtalkwiki_2_0.Client client = Sample.createClient(); com.aliyun.dingtalkwiki_2_0.models.GetWorkspaceHeaders getWorkspaceHeaders = new com.aliyun.dingtalkwiki_2_0.models.GetWorkspaceHeaders(); getWorkspaceHeaders.xAcsDingtalkAccessToken = ""; com.aliyun.dingtalkwiki_2_0.models.GetWorkspaceRequest getWorkspaceRequest = new com.aliyun.dingtalkwiki_2_0.models.GetWorkspaceRequest() .setWithPermissionRole(false) .setOperatorId("tXguN309iPhE4roSKPlLURAiEiE"); try { client.getWorkspaceWithOptions("MJ0pDSKMV9dO20E4", getWorkspaceRequest, getWorkspaceHeaders, 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 berisi properti code dan message, yang membantu menemukan 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 berisi properti code dan message, yang membantu menemukan 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.wiki_2_0.client import Client as dingtalkwiki_2_0Client from alibabacloud_tea_openapi import models as open_api_models from alibabacloud_dingtalk.wiki_2_0 import models as dingtalkwiki__2__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() -> dingtalkwiki_2_0Client: """ Initialize the account Client using the Token @return: Client @throws Exception """ config = open_api_models.Config() config.protocol = 'https' config.region_id = 'central' return dingtalkwiki_2_0Client(config) @staticmethod def main( args: List[str], ) -> None: client = Sample.create_client() get_workspace_headers = dingtalkwiki__2__0_models.GetWorkspaceHeaders() get_workspace_headers.x_acs_dingtalk_access_token = '' get_workspace_request = dingtalkwiki__2__0_models.GetWorkspaceRequest( with_permission_role=False, operator_id='tXguN309iPhE4roSKPlLURAiEiE' ) try: client.get_workspace_with_options('MJ0pDSKMV9dO20E4', get_workspace_request, get_workspace_headers, util_models.RuntimeOptions()) except Exception as err: if not UtilClient.empty(err.code) and not UtilClient.empty(err.message): # err berisi properti code dan message, yang membantu menemukan issue pass @staticmethod async def main_async( args: List[str], ) -> None: client = Sample.create_client() get_workspace_headers = dingtalkwiki__2__0_models.GetWorkspaceHeaders() get_workspace_headers.x_acs_dingtalk_access_token = '' get_workspace_request = dingtalkwiki__2__0_models.GetWorkspaceRequest( with_permission_role=False, operator_id='tXguN309iPhE4roSKPlLURAiEiE' ) try: await client.get_workspace_with_options_async('MJ0pDSKMV9dO20E4', get_workspace_request, get_workspace_headers, util_models.RuntimeOptions()) except Exception as err: if not UtilClient.empty(err.code) and not UtilClient.empty(err.message): # err berisi properti code dan message, yang membantu menemukan 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(); $getWorkspaceHeaders = new GetWorkspaceHeaders([]); $getWorkspaceHeaders->xAcsDingtalkAccessToken = ""; $getWorkspaceRequest = new GetWorkspaceRequest([ "withPermissionRole" => false, "operatorId" => "tXguN309iPhE4roSKPlLURAiEiE" ]); try { $client->getWorkspaceWithOptions("MJ0pDSKMV9dO20E4", $getWorkspaceRequest, $getWorkspaceHeaders, 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 berisi properti code dan message, yang membantu menemukan 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" dingtalkwiki_2_0 "github.com/alibabacloud-go/dingtalk/wiki_2_0" openapi "github.com/alibabacloud-go/darabonba-openapi/v2/client" "github.com/alibabacloud-go/tea/tea" ) /** * Initialize the account Client using the Token * @return Client * @throws Exception */ func CreateClient () (_result *dingtalkwiki_2_0.Client, _err error) { config := &openapi.Config{} config.Protocol = tea.String("https") config.RegionId = tea.String("central") _result = &dingtalkwiki_2_0.Client{} _result, _err = dingtalkwiki_2_0.NewClient(config) return _result, _err } func _main (args []*string) (_err error) { client, _err := CreateClient() if _err != nil { return _err } getWorkspaceHeaders := &dingtalkwiki_2_0.GetWorkspaceHeaders{} getWorkspaceHeaders.XAcsDingtalkAccessToken = tea.String("") getWorkspaceRequest := &dingtalkwiki_2_0.GetWorkspaceRequest{ WithPermissionRole: tea.Bool(false), OperatorId: tea.String("tXguN309iPhE4roSKPlLURAiEiE"), } tryErr := func()(_e error) { defer func() { if r := tea.Recover(recover()); r != nil { _e = r } }() _, _err = client.GetWorkspaceWithOptions(tea.String("MJ0pDSKMV9dO20E4"), getWorkspaceRequest, getWorkspaceHeaders, &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 berisi properti code dan message, yang membantu menemukan 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 dingtalkwiki_2_0, * as $dingtalkwiki_2_0 from '@alicloud/dingtalk/wiki_2_0'; import OpenApi, * as $OpenApi from '@alicloud/openapi-client'; import * as $tea from '@alicloud/tea-typescript'; export default class Client { /** * Initialize the account Client using the Token * @return Client * @throws Exception */ static createClient(): dingtalkwiki_2_0 { let config = new $OpenApi.Config({ }); config.protocol = "https"; config.regionId = "central"; return new dingtalkwiki_2_0(config); } static async main(args: string[]): Promise { let client = Client.createClient(); let getWorkspaceHeaders = new $dingtalkwiki_2_0.GetWorkspaceHeaders({ }); getWorkspaceHeaders.xAcsDingtalkAccessToken = ""; let getWorkspaceRequest = new $dingtalkwiki_2_0.GetWorkspaceRequest({ withPermissionRole: false, operatorId: "tXguN309iPhE4roSKPlLURAiEiE", }); try { await client.getWorkspaceWithOptions("MJ0pDSKMV9dO20E4", getWorkspaceRequest, getWorkspaceHeaders, new $Util.RuntimeOptions({ })); } catch (err) { if (!Util.empty(err.code) && !Util.empty(err.message)) { // err berisi properti code dan message, yang membantu menemukan 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 using the Token * @return Client * @throws Exception */ public static AlibabaCloud.SDK.Dingtalkwiki_2_0.Client CreateClient() { AlibabaCloud.OpenApiClient.Models.Config config = new AlibabaCloud.OpenApiClient.Models.Config(); config.Protocol = "https"; config.RegionId = "central"; return new AlibabaCloud.SDK.Dingtalkwiki_2_0.Client(config); } public static void Main(string[] args) { AlibabaCloud.SDK.Dingtalkwiki_2_0.Client client = CreateClient(); AlibabaCloud.SDK.Dingtalkwiki_2_0.Models.GetWorkspaceHeaders getWorkspaceHeaders = new AlibabaCloud.SDK.Dingtalkwiki_2_0.Models.GetWorkspaceHeaders(); getWorkspaceHeaders.XAcsDingtalkAccessToken = ""; AlibabaCloud.SDK.Dingtalkwiki_2_0.Models.GetWorkspaceRequest getWorkspaceRequest = new AlibabaCloud.SDK.Dingtalkwiki_2_0.Models.GetWorkspaceRequest { WithPermissionRole = false, OperatorId = "tXguN309iPhE4roSKPlLURAiEiE", }; try { client.GetWorkspaceWithOptions("MJ0pDSKMV9dO20E4", getWorkspaceRequest, getWorkspaceHeaders, new AlibabaCloud.TeaUtil.Models.RuntimeOptions()); } catch (TeaException err) { if (!AlibabaCloud.TeaUtil.Common.Empty(err.Code) && !AlibabaCloud.TeaUtil.Common.Empty(err.Message)) { // err berisi properti code dan message, yang membantu menemukan 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 berisi properti code dan message, yang membantu menemukan issue } } } } } ``` ## Respons ### Isi respons | Nama | Tipe | Deskripsi | | -------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | workspace | Object | Knowledge Base. | | workspaceId | String | ID Knowledge Base (spaceUuid). | | corpId | String | ID organisasi yang memiliki Knowledge Base. | | teamId | String | ID Grup Pengetahuan yang memiliki Knowledge Base. Kosong jika tidak dikaitkan dengan Grup Pengetahuan mana pun. | | rootNodeId | String | ID node root (root dentryUuid). | | name | String | Nama Knowledge Base. | | type | String | Tipe Knowledge Base. Nilai enum: - **TEAM**: Knowledge Base - **PERSONAL**: Dokumen Saya | | description | String | Deskripsi Knowledge Base. | | url | String | URL akses Knowledge Base. | | icon | Object | Ikon Knowledge Base. | | type | String | Tipe ikon. Nilai enum: - **URL**: tautan - **EMOJI**: ikon emoji | | value | String | Nilai ikon: - Ketika type adalah URL, mengembalikan tautan ikon. - Ketika type adalah EMOJI, mengembalikan nilai Unicode ikon emoji. | | cover | String | URL sampul Knowledge Base. | | creatorId | String | userId pembuat Knowledge Base. | | modifierId | String | userId pengubah Knowledge Base. | | createTime | String | Waktu pembuatan Knowledge Base. | | modifiedTime | String | Waktu modifikasi Knowledge Base. | | permissionRole | String | Peran izin pemohon pada Knowledge Base. Nilai enum: - **OWNER**: Pemilik - **MANAGER**: Manajer - **EDITOR**: Editor - **DOWNLOADER**: Penampil dengan izin unduh - **READER**: Hanya penampil - **NONE**: Tidak ada izin | ### Contoh isi respons ```text theme={"theme":{"light":"github-light","dark":"github-dark"}} HTTP/1.1 200 OK Content-Type:application/json { "workspace" : { "workspaceId" : "MJ0pDSKMV9dO20E4", "corpId" : "ding16b241fd05********288", "teamId" : "lHiicjNFM2iSFYSdz2iPuI8ZwiEiE", "rootNodeId" : "ydxXB52LJqqK7xxNTXyo390kJqjMp697", "name" : "workspace_name", "type" : "TEAM", "description" : "workspace_description", "url" : "workspace_url", "icon" : { "type" : "URL", "value" : "https://example/file-manage-files/zh-CN/202***13/ldet/avatar3.jpg" }, "cover" : "https://example/file-manage-files/zh-CN/202***13/ldet/XXXX.jpg", "creatorId" : "01472825524039877041", "modifierId" : "01472825524039877041", "createTime" : "2023-05-15T11:29Z", "modifiedTime" : "2023-05-15T11:29Z", "permissionRole" : "READER" } } ``` ### Kode error Jika terjadi error saat memanggil API ini, lihat dokumen [Kode error global](/id/open/development/server-api-error-codes-1) untuk menemukan solusi berdasarkan pesan error. | HttpCode | Kode error | Pesan error | Deskripsi | | -------- | ----------------- | ------------- | -------------------------------------------------------- | | 400 | paramError | %s | Error parameter | | 400 | isNotWorkspace | %s | Bukan Knowledge Base | | 403 | permissionDenied | %s | Pengguna saat ini tidak memiliki izin untuk tindakan ini | | 404 | workspaceNotExist | %s | Knowledge Base tidak ada | | 500 | systemError | %s | Layanan sibuk. Coba lagi nanti | | 500 | unknownError | Unknown Error | Error tidak dikenal | | 503 | operationTimeout | %s | Permintaan habis waktu |