Request
Basic information
| Field | Value |
|---|---|
| HTTP URL | https://api.dingtalk.io/v1.0/notable/bases/{baseId}/sheets |
| HTTP Method | GET |
| Supported app type | appType-Internal app |
| Permissions required | permission-Notable.Base.Read.All-Read permissions for AI Table apps |
Request header
| Name | Type | Required | Description |
|---|---|---|---|
| x-acs-dingtalk-access-token | String | Yes | The access credential for calling this API. Obtain it by calling the Get the access token of an internal app API. |
Path parameter
| Name | Type | Required | Description |
|---|---|---|---|
| baseId | String | Yes | The ID of the AI Table. For how to obtain it, see Data structure. |
Query parameter
| Name | Type | Required | Description |
|---|---|---|---|
| operatorId | String | Yes | The unionId of the operator. Obtain it in either of the following ways: - Call the Query user details API. - Call the Obtain the user ID of a user by using the silent login code API. |
Request example
HTTPResponse
Response body
| Name | Type | Description |
|---|---|---|
| value | Array | The list of tables. |
| id | String | The table ID. |
| name | String | The table name. |
Response body example
Error codes
If an error occurs when you call this API, find a solution in the Global error codes documentation based on the error message.| HttpCode | Error code | Error message | Description |
|---|---|---|---|
| 500 | internalError | The server encountered an internal error and was unable to complete your request. Please try again later. | System error. |
| 500 | unknownError | Unknown Error | Unknown error. |
| 400 | invalidRequest.inputArgs.invalid | %s | The request parameter is invalid. See the error message for details. |
| 400 | invalidRequest.document.stillInitializing | The document is under initialization. Please try again later | The document is initializing. Try again later. |
| 400 | invalidRequest.document.broken | The document is broken and the server is unable to complete your request. | The document is broken. |
| 403 | forbidden.operationIllegal | %s | No permissions. |
| 403 | invalidRequest.document.typeIllegal | %s | Unsupported document type. Check the 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. | The document does not exist. |
| 404 | invalidRequest.resource.notFound | %s | The resource does not exist. The data does not exist or has been permanently deleted. |
| 504 | service.timeout | The server is busy and unable to complete your request. Please try again later. | Request timed out. |