获取应用列表

POST

http://127.0.0.1/microapp/list

服务端API/应用管理

最后修改时间：2022-08-30 09:19:21

责任人：未设置

说明

调用该接口获取当前企业的应用列表。
服务地址：https://oapi.dingtalk.com

权限

服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。

应用类型	是否支持调用	权限申请方式	API Explorer调试
企业内部应用	是	开发者后台申请	调试
第三方企业应用	否	—	—
第三方个人应用	否	—	—

请求参数

Query 参数

access_token

string

必需

调用服务端接口的授权凭证。企业内部应用可通过调用access_token接口获得。

示例值:

6d1bxxxx

Body 参数application/json

object {0}

示例

{}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://127.0.0.1/microapp/list?access_token=6d1bxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{}'

返回响应

🟢200成功

application/json

Body

appList

array [object {9}]

应用信息。

可选

name

string

应用名称。

可选

agentId

number

应用ID。

可选

appIcon

string

用图标地址。

可选

appDesc

string

应用描述。

可选

isSelf

boolean

可选

是否是自建应用：false：不是true：自建

appStatus

number

可选

应用状态：0表示停用1表示启用2表示未激活3表示服务到期

ompLink

string

可选

应用的OA后台管理主页。

homepageLink

string

应用的移动端主页。

可选

pcHomepageLink

string

应用的PC端主页。

可选

errmsg

string

返回码描述。

可选

errcode

number

返回码。

可选

示例

{
  "appList": [
    {
      "name": "string",
      "agentId": 0,
      "appIcon": "string",
      "appDesc": "string",
      "isSelf": true,
      "appStatus": 0,
      "ompLink": "string",
      "homepageLink": "string",
      "pcHomepageLink": "string"
    }
  ],
  "errmsg": "string",
  "errcode": 0
}

获取员工可见的应用列表

获取应用列表

说明#

权限#

请求参数

示例代码

返回响应

说明

权限