跳到主要内容

获取应用基本信息

调用本接口,获取应用基本信息。


权限说明

仅「超管accessToken」拥有调用权限。(权限组accessToken无法调用)

请求

**请求方式:**GET

**请求地址:**https://api.qingflow.com/apps(公有云版本)

示例如下:

GET https://api.qingflow.com/apps

钉钉版本:https://api.ding.qingflow.com/apps

专有轻流:http(s)://xxx.xx(自有域名)/openApi/apps

2.1 参数说明(查询参数):
参数必须类型说明
appKeystring应用ID,不填则默认工作区内所有应用
pageSizeint每页数据条数
pageNumint请求页码
2.2 请求头(Header)
参数必须说明
accessToken调用接口凭证。获取方法请查看“文档”

返回

3.1 返回体
参数名必含类型说明
errCodeint错误码,非0表示失败
errMsgstring错误描述
questionRelations关联的设置,这里没用
resultobject结果
pageNumint请求页码
pegeSizeint每页数据条数
resultAmountint总数据条数
pageAmountint总页数
resultarray
appKeystring应用的key
appNamestring应用的标题
appAuthint应用的可见权限, 1-2分别代表:工作区可查看,指定用户
authMembersobject指定用户可见的时候,可见的用户列表,不支持动态负责人
usersarray用户列表
userIdstring用户id
userNamestring用户昵称
deptsarray部门列表
deptIdint部门id
deptNamestring部门名称
rolesarray角色列表
roleIdint角色id
roleNamestring角色名称
creatorobject应用创建者
userIdstring应用创建者的userid
nickNamestring应用创建者的昵称
headImgstring应用创建者的头像
createTimeint应用的创建时间
appIconstring应用的图标
tagsarray应用所属的应用包
tagIdint应用包id
tagNamestring应用包名称
appPublishStatusint应用的发布状态
3.2 返回体示例
{
"errCode": 0,
"errMsg": null,
"questionRelations": [],
"result": {
"pageAmount": 1,
"pageNum": 1,
"pageSize": 20,
"result": [
{
"appAuth": 2,
"appIcon": "https://file.qingflow.com/assets/mobile/images/icon_appase.png",
"appKey": "00071f",
"appName": "未命名应用",
"appPublishStatus": 0,
"authMembers": {
"depts": [],
"roles": [],
"users": [
{
"userId": "9098",
"userName": "pony"
},
{
"userId": "9024",
"userName": "snow"
}
]
},
"createTime": "2022-02-09T17:15:07",
"creator": {
"headImg": "https://file.qingflow.com/assets/contact/avar1.png",
"nickName": "",
"userId": "6889"
},
"tags": [
{
"userId": "3909",
"userName": "pony"

},
{
"userId": "3904",
"userName": "snow"

}
]
}
],
"resultAmount": 1
}
}
3.3 错误码相关