文档中心 > API类目 > 钉钉API

dingtalk.oapi.microapp.list (列出微应用)

列出微应用

公共参数

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

名称	类型	是否必须	描述
access_token	String	是	钉钉提供的授权Token，想了解详情，ISV开发者请点击这里，企业开发者请点击这里。若有疑问，咨询邮箱dingding_open_dingtalk#list.alibaba-inc.com。

请求参数

名称	类型	是否必须	示例值	更多限制	描述

响应参数

名称	类型	描述
appList	Applist []	appList
└ name String 微应用名称 └ agentId Number 微应用实例化id └ appIcon String 微应用图标 └ appDesc String 微应用描述 └ isSelf Boolean 表示是否是自建微应用 └ appStatus Number 微应用状态，1表示启用，0表示停用 └ ompLink String 微应用的OA后台管理主页 └ homepageLink String 微应用的移动端主页 └ pcHomepageLink String 微应用的pc端主页 └ appId Number 三方应用id
errmsg	String	对返回码的文本描述内容
errcode	Number	返回码

请求示例

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/microapp/list");
OapiMicroappListRequest req = new OapiMicroappListRequest();
OapiMicroappListResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

响应示例

JSON示例

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

异常示例

JSON示例

{
    "error_response":{
        "msg":"Remote service error",
        "code":50,
        "sub_msg":"非法参数",
        "sub_code":"isv.invalid-parameter"
    }
}

错误码解释

错误码	错误描述	解决方案

API工具

API测试工具错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问

返回
顶部

开放平台

钉钉API

dingtalk.oapi.microapp.list (列出微应用)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ