> ## 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. # Menampilkan beberapa rekaman > Panggil API ini untuk mengambil beberapa baris rekaman dari tabel data AI Table tertentu dengan dukungan paginasi untuk melakukan kueri dan menelusuri data tabel di DingTalk. Panggil API ini untuk mengambil beberapa rekaman dari tabel tertentu di AI Table. ## Permintaan ### Informasi dasar | Bidang | Nilai | | ---------------------------- | ----------------------------------------------------------------------------------------- | | URL HTTP | `https://api.dingtalk.io/v1.0/notable/bases/{baseId}/sheets/{sheetIdOrName}/records/list` | | Metode HTTP | POST | | Jenis aplikasi yang didukung | appType-Internal app | | Izin yang diperlukan | permission-Notable.Base.Read.All-AI Table app read permission | ### Header permintaan | Nama | Tipe | Wajib | Deskripsi | | --------------------------- | ------ | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | x-acs-dingtalk-access-token | String | Ya | Kredensial akses yang digunakan untuk memanggil API ini. Untuk memperolehnya, lihat [Memperoleh access token dari aplikasi internal](/id/open/development/obtain-the-access-token-of-an-internal-app). | ### Parameter path | Nama | Tipe | Wajib | Deskripsi | | ------------- | ------ | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | baseId | String | Ya | ID dari AI Table. Untuk memperolehnya, lihat [Struktur data](/id/open/development/data-structure). | | sheetIdOrName | String | Ya | ID tabel atau nama tabel. Anda dapat memperoleh ID tabel melalui salah satu cara berikut: - Panggil API [Memperoleh semua tabel](/id/open/development/api-notable-getallsheets). - Panggil API [Memperoleh sebuah tabel](/id/open/development/api-notable-getsheet). | ### Parameter kueri | Nama | Tipe | Wajib | Deskripsi | | ---------- | ------ | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | operatorId | String | Ya | unionId dari operator. Anda dapat memperolehnya melalui salah satu cara berikut: - Panggil API [Kueri detail pengguna](/id/open/development/query-user-details). - Panggil API [Memperoleh informasi pengguna menggunakan kode login senyap](/id/open/development/obtain-the-userid-of-a-user-by-using-the-log-free). | ### Isi permintaan | Nama | Tipe | Wajib | Deskripsi | | | | | | | | | | | -------------- | --------------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------- | ------------ | ---- | --------- | ------- | ---------- | ----- | --------- | | filter | Object | Tidak | Filter. Ketika ditetapkan, hanya rekaman yang memenuhi kondisi yang dikembalikan. | | | | | | | | | | | combination | String | Tidak | Mode kombinasi dari kondisi. Nilai yang valid: - **and**: Semua kondisi harus terpenuhi. - **or**: Salah satu kondisi dapat terpenuhi. | | | | | | | | | | | conditions | Array | Ya | Kondisi. | | | | | | | | | | | field | String | Ya | ID field atau nama field. | | | | | | | | | | | operator | String | Ya | Operator kondisi: equal | notEqual | greater | greaterEqual | less | lessEqual | contain | notContain | empty | notEmpty. | | value | Array of Any | Tidak | Nilai kondisi. Lihat [Format nilai rekaman](https://open.dingtalk.com/document/development/record-value-format). | | | | | | | | | | | maxResults | Integer | Tidak | Jumlah rekaman yang dikembalikan per halaman. Default: 100. Minimum: 1. Maksimum: 100. | | | | | | | | | | | nextToken | String | Tidak | Cursor paginasi yang dikembalikan oleh kueri sebelumnya. Kosongkan untuk kueri pertama. | | | | | | | | | | | fieldIdOrNames | Array of String | Tidak | Opsional. Daftar field yang akan dikembalikan. Ketika terdapat banyak field, sertakan hanya yang diperlukan untuk mengurangi ukuran respons secara signifikan. Maksimum 100 field per permintaan. | | | | | | | | | | ### Contoh permintaan HTTP ```http theme={"theme":{"light":"github-light","dark":"github-dark"}} POST /v1.0/notable/bases/qnYxxx/sheets/Table/records/list?operatorId=union_id HTTP/1.1 Host:api.dingtalk.io x-acs-dingtalk-access-token:xxxxx Content-Type:application/json { "maxResults" : 100, "nextToken" : "tuvxxx", "filter": { "conditions": [{ "field": 'Number', "operator": 'equal', "value": [32], }], }, } ``` 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 { /** * description : *

Initialize the account Client using a Token

* @return Client * * @throws Exception */ public static com.aliyun.dingtalknotable_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.dingtalknotable_1_0.Client(config); } public static void main(String[] args_) throws Exception { com.aliyun.dingtalknotable_1_0.Client client = Sample.createClient(); com.aliyun.dingtalknotable_1_0.models.ListRecordsHeaders listRecordsHeaders = new com.aliyun.dingtalknotable_1_0.models.ListRecordsHeaders(); listRecordsHeaders.xAcsDingtalkAccessToken = ""; com.aliyun.dingtalknotable_1_0.models.ListRecordsRequest listRecordsRequest = new com.aliyun.dingtalknotable_1_0.models.ListRecordsRequest() .setOperatorId("union_id") .setMaxResults(100) .setNextToken("tuvxxx"); try { client.listRecordsWithOptions("qnYxxx", "Table", listRecordsRequest, listRecordsHeaders, new com.aliyun.teautil.models.RuntimeOptions()); } catch (TeaException err) { if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) { // The err object contains code and message attributes that help with troubleshooting } } 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)) { // The err object contains code and message attributes that help with troubleshooting } } } } ``` 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.notable_1_0.client import Client as dingtalknotable_1_0Client from alibabacloud_tea_openapi import models as open_api_models from alibabacloud_dingtalk.notable_1_0 import models as dingtalknotable__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() -> dingtalknotable_1_0Client: """ Initialize the account Client using a Token @return: Client @throws Exception """ config = open_api_models.Config() config.protocol = 'https' config.region_id = 'central' return dingtalknotable_1_0Client(config) @staticmethod def main( args: List[str], ) -> None: client = Sample.create_client() list_records_headers = dingtalknotable__1__0_models.ListRecordsHeaders() list_records_headers.x_acs_dingtalk_access_token = '' list_records_request = dingtalknotable__1__0_models.ListRecordsRequest( operator_id='union_id', max_results=100, next_token='tuvxxx' ) try: client.list_records_with_options('qnYxxx', 'Table', list_records_request, list_records_headers, util_models.RuntimeOptions()) except Exception as err: if not UtilClient.empty(err.code) and not UtilClient.empty(err.message): # The err object contains code and message attributes that help with troubleshooting pass @staticmethod async def main_async( args: List[str], ) -> None: client = Sample.create_client() list_records_headers = dingtalknotable__1__0_models.ListRecordsHeaders() list_records_headers.x_acs_dingtalk_access_token = '' list_records_request = dingtalknotable__1__0_models.ListRecordsRequest( operator_id='union_id', max_results=100, next_token='tuvxxx' ) try: await client.list_records_with_options_async('qnYxxx', 'Table', list_records_request, list_records_headers, util_models.RuntimeOptions()) except Exception as err: if not UtilClient.empty(err.code) and not UtilClient.empty(err.message): # The err object contains code and message attributes that help with troubleshooting 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(); $listRecordsHeaders = new ListRecordsHeaders([]); $listRecordsHeaders->xAcsDingtalkAccessToken = ""; $listRecordsRequest = new ListRecordsRequest([ "operatorId" => "union_id", "maxResults" => 100, "nextToken" => "tuvxxx" ]); try { $client->listRecordsWithOptions("qnYxxx", "Table", $listRecordsRequest, $listRecordsHeaders, 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)) { // The err object contains code and message attributes that help with troubleshooting } } } } $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 ( "encoding/json" "strings" "fmt" "os" util "github.com/alibabacloud-go/tea-utils/v2/service" dingtalknotable_1_0 "github.com/alibabacloud-go/dingtalk/notable_1_0" openapi "github.com/alibabacloud-go/darabonba-openapi/v2/client" "github.com/alibabacloud-go/tea/tea" ) // Description: // // Initialize the account Client using a Token // // @return Client // // @throws Exception func CreateClient () (_result *dingtalknotable_1_0.Client, _err error) { config := &openapi.Config{} config.Protocol = tea.String("https") config.RegionId = tea.String("central") _result = &dingtalknotable_1_0.Client{} _result, _err = dingtalknotable_1_0.NewClient(config) return _result, _err } func _main (args []*string) (_err error) { client, _err := CreateClient() if _err != nil { return _err } listRecordsHeaders := &dingtalknotable_1_0.ListRecordsHeaders{} listRecordsHeaders.XAcsDingtalkAccessToken = tea.String("") listRecordsRequest := &dingtalknotable_1_0.ListRecordsRequest{ OperatorId: tea.String("union_id"), MaxResults: tea.Int32(100), NextToken: tea.String("tuvxxx"), } tryErr := func()(_e error) { defer func() { if r := tea.Recover(recover()); r != nil { _e = r } }() _, _err = client.ListRecordsWithOptions(tea.String("qnYxxx"), tea.String("Table"), listRecordsRequest, listRecordsHeaders, &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)) { // The err object contains code and message attributes that help with troubleshooting } } return _err } func main() { err := _main(tea.StringSlice(os.Args[1:])) if err != nil { panic(err) } } ``` Node.js ```text theme={"theme":{"light":"github-light","dark":"github-dark"}} 'use strict'; // This file is auto-generated, don't edit it const Util = require('@alicloud/tea-util'); const dingtalknotable_1_0 = require('@alicloud/dingtalk/notable_1_0'); const OpenApi = require('@alicloud/openapi-client'); const Tea = require('@alicloud/tea-typescript'); class Client { /** * Initialize the account Client using a Token * @return Client * @throws Exception */ static createClient() { let config = new OpenApi.Config({ }); config.protocol = 'https'; config.regionId = 'central'; return new dingtalknotable_1_0.default(config); } static async main(args) { let client = Client.createClient(); let listRecordsHeaders = new dingtalknotable_1_0.ListRecordsHeaders({ }); listRecordsHeaders.xAcsDingtalkAccessToken = ''; let listRecordsRequest = new dingtalknotable_1_0.ListRecordsRequest({ operatorId: 'union_id', maxResults: 100, nextToken: 'tuvxxx', }); try { await client.listRecordsWithOptions('qnYxxx', 'Table', listRecordsRequest, listRecordsHeaders, new Util.RuntimeOptions({ })); } catch (err) { if (!Util.default.empty(err.code) && !Util.default.empty(err.message)) { // The err object contains code and message attributes that help with troubleshooting } } } } exports.Client = Client; 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 { /// Description: /// /// Initialize the account Client using a Token /// /// /// /// Client /// /// /// Exception: /// Exception public static AlibabaCloud.SDK.Dingtalknotable_1_0.Client CreateClient() { AlibabaCloud.OpenApiClient.Models.Config config = new AlibabaCloud.OpenApiClient.Models.Config(); config.Protocol = "https"; config.RegionId = "central"; return new AlibabaCloud.SDK.Dingtalknotable_1_0.Client(config); } public static void Main(string[] args) { AlibabaCloud.SDK.Dingtalknotable_1_0.Client client = CreateClient(); AlibabaCloud.SDK.Dingtalknotable_1_0.Models.ListRecordsHeaders listRecordsHeaders = new AlibabaCloud.SDK.Dingtalknotable_1_0.Models.ListRecordsHeaders(); listRecordsHeaders.XAcsDingtalkAccessToken = ""; AlibabaCloud.SDK.Dingtalknotable_1_0.Models.ListRecordsRequest listRecordsRequest = new AlibabaCloud.SDK.Dingtalknotable_1_0.Models.ListRecordsRequest { OperatorId = "union_id", MaxResults = 100, NextToken = "tuvxxx", }; try { client.ListRecordsWithOptions("qnYxxx", "Table", listRecordsRequest, listRecordsHeaders, new AlibabaCloud.TeaUtil.Models.RuntimeOptions()); } catch (TeaException err) { if (!AlibabaCloud.TeaUtil.Common.Empty(err.Code) && !AlibabaCloud.TeaUtil.Common.Empty(err.Message)) { // The err object contains code and message attributes that help with troubleshooting } } 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)) { // The err object contains code and message attributes that help with troubleshooting } } } } } ``` ## Respons ### Isi respons | Nama | Tipe | Deskripsi | | ---------------- | ------------------ | ----------------------------------------------- | | hasMore | Boolean | Menunjukkan apakah masih tersedia data lainnya. | | nextToken | String | Cursor paginasi. | | records | Array | Daftar rekaman. | | id | String | ID rekaman. | | fields | `Map` | Nilai field. | | | Any | Nilai field. | | createdBy | Object | Pembuat. | | unionId | String | unionId dari pembuat. | | lastModifiedBy | Object | Pihak yang terakhir mengubah. | | unionId | String | unionId dari pihak yang terakhir mengubah. | | createdTime | Long | Waktu pembuatan. | | lastModifiedTime | Long | Waktu modifikasi terakhir. | ### Contoh respons ```text theme={"theme":{"light":"github-light","dark":"github-dark"}} HTTP/1.1 200 OK Content-Type:application/json { "hasMore" : true, "nextToken" : "nextToken", "records" : [ { "id" : "qkexxx", "fields" : { "Number" : 32 }, "createdBy" : { "unionId" : "union_id" }, "lastModifiedBy" : { "unionId" : "union_id" }, "createdTime" : 1728644688000, "lastModifiedTime" : 1728644688000 } ] } ``` ### Kode error Jika error dikembalikan 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 | invalidRequest.inputArgs.invalid | %s | Parameter permintaan tidak valid. Lihat pesan error untuk detailnya. | | 400 | invalidRequest.document.stillInitializing | The document is under initialization. Please try again later | Dokumen sedang diinisialisasi. Coba lagi nanti. | | 400 | invalidRequest.document.broken | The document is broken and the server is unable to complete your request. | Dokumen rusak. | | 400 | invalidRequest.dataNotReady | The requested data is not available yet. Please try again later. | Sumber daya atau data yang diminta belum siap. | | 403 | forbidden.operationIllegal | %s | Tidak memiliki izin. | | 403 | invalidRequest.document.typeIllegal | %s | Tipe dokumen tidak didukung. Periksa baseId. | | 404 | invalidRequest.document.notFound | Fail to find the requested resource by the given baseId. Please make sure the given baseId is valid, and the operatorId has permission to access it. | Dokumen tidak ada. | | 404 | invalidRequest.resource.notFound | %s | Sumber daya tidak ada. Data tidak ada atau telah dihapus secara permanen. | | 500 | internalError | The server encountered an internal error and was unable to complete your request. Please try again later. | Error sistem. | | 500 | unknownError | Unknown Error | Error tidak diketahui. | | 504 | service.timeout | The server is busy and unable to complete your request. Please try again later. | Permintaan melebihi batas waktu. |