Request
Basic information
| Field | Value |
|---|---|
| HTTP URL | https://api.dingtalk.io/v1.0/storage/recycleBins/{recycleBinId}/recycleItems/{recycleItemId} |
| HTTP Method | GET |
| Supported app types | appType-Internal app appType-Third-party enterprise app |
| Permission requirements | permission-Storage.RecycleBin.Read-Read permission for the Organization storage Recycle Bin |
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
| x-acs-dingtalk-access-token | String | Yes | The access credential for calling this API. Obtain it as follows: - For an Internal app, call the Get the access token of an internal app API. - For a Third-party enterprise app, call the Get the access token of an organization that authorized a third-party app API. |
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| recycleBinId | String | Yes | The Recycle Bin ID. Call the Get information about the Recycle Bin API to obtain it. |
| recycleItemId | String | Yes | The recycle item ID. Call the Get the list of recycle items API to obtain the value of the id parameter. |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
| unionId | String | Yes | The unionId of the operator. Call the Query user details API to obtain it. |
Request example
HTTPResponse
Response body
| Name | Type | Description |
|---|---|---|
| item | Object | The recycle item information. |
| id | String | The recycle item ID. |
| spaceId | String | The ID of the Space where the original File or Folder was located. |
| dentryId | String | The ID of the original File or Folder. |
| size | Long | The size of the original File or Folder, in bytes. |
| type | String | The type. - FILE: File - FOLDER: Folder |
| originalName | String | The name of the original File or Folder. |
| originalPath | String | The path of the original File or Folder. |
| operatorId | String | The unionId of the user who performed the delete action. |
| operatorTime | String | The deletion time, in ISO 8601 format. Example: 2022-07-29T14:55Z. |
Response body example
Error codes
If an error occurs when you call this API, find the solution in the Global error codes document based on the error message.| HttpCode | Error code | Error message | Description |
|---|---|---|---|
| 400 | paramError | %s | Parameter error |
| 400 | paramError.recycleBinId | %s | Parameter error - recycleBinId |
| 403 | permissionDenied | %s | The user lacks View Permission for the original File (or Folder) of the recycle item |
| 404 | recycleBinNotExist | %s | The Recycle Bin does not exist |
| 404 | recycleItemNotExist | %s | The recycle item does not exist |
| 500 | systemError | %s | System error |
| 500 | unknownError | Unknown Error | Unknown error |
| 503 | operationTimeout | %s | Request timeout |