Request
Basic information
| Field | Value |
|---|---|
| HTTP URL | https://api.dingtalk.io/v1.0/robot/plugins/query |
| HTTP Method | POST |
| Supported app type | appType-Internal app |
| Required permissions | permission-Robot.SingleChat.ReadWrite-Single-chat bot management permission |
Request header
| Name | Type | Required | Description |
|---|---|---|---|
| x-acs-dingtalk-access-token | String | Yes | The access credential used to call this API. Obtain it by calling Get the access token of an internal app. |
Request body
| Name | Type | Required | Description |
|---|---|---|---|
| robotCode | String | Yes | The code of the bot. See Bot glossary - robotCode for details on how to obtain robotCode. |
Request example
HTTPResponse
Response body
| Name | Type | Description |
|---|---|---|
| pluginInfoList | Array | The list of quick entries. |
| name | String | The name of the quick entry. Supports internationalization, for example: {"en_US":"test123","zh_CN":"Test123"}. |
| icon | String | The icon ID of the quick entry. |
| pcUrl | String | The redirect link for the quick entry in PC chats. |
| mobileUrl | String | The redirect link for the quick entry on mobile. |
Response body example
Error codes
If an error occurs when calling this API, look up the solution based on the error message in the Global error codes document.| HttpCode | Error code | Error message | Description |
|---|---|---|---|
| 400 | param.illegal | parameter error | parameter error |
| 400 | invalidRequest.robotCodeNotMatch | The app does not match the bound bot’s robotCode | The app does not match the bound bot’s robotCode |
| 400 | invalidRequest.robotNotExist | The bot does not exist. Verify and add it again | The bot does not exist. Verify and add it again |
| 400 | invalidRequest.robotIsStop | The bot has been disabled by the organization | The bot has been disabled by the organization |
| 400 | invalidRequest.exceededMaximumLimit | Exceeded the maximum number of plugins allowed | Exceeded the maximum number of plugins allowed |
| 400 | invalidRequest.jsonFormatErroj | Invalid JSON format | Invalid JSON format |
| 500 | system.error | system error | system error |
| 500 | invalidRequest.pluginInstallFail | Plugin installation failed | Plugin installation failed |