跳到主要内容

更新应用包

调用本接口,更新应用包信息


权限说明

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

请求

**请求方式:**POST

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

其他版本请求地址:

钉钉版本:https://api.ding.qingflow.com/tag/update

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

2.1 请求头(Header)
参数必须说明
accessToken调用接口凭证。获取方法请查看“文档”
2.2 请求体(Body)
参数必须类型说明
tagIdint应用包id
tagNamestring应用包名称(1-100字符)可含空格
tagAuthint可见权限:1:工作区可查看(默认值) 2: 指定用户可见
authMembersobjecttagAuth为2时填写,默认为(超/系统)管理员可见;tagAuth为1时填写无效
userIds[array]用户id列表
deptIds[array]部门id列表
roleIds[array]角色id列表
includeSubDepartsboolean是否动态包含已选部门下的子部门,默认true
tagIconstring应用包图标,格式为链接或指定格式字符串(如下)默认值"{"icon":null,"iconColor":"qing-orange","iconName":null}"(应用包首字+橙色底)
2.3 请求体示例
{
"tagid": 12484,
"tagName": "new tag",
"tagAuth": "2",
"authMembers": {
"userIds": ["8935""7883"],
"deptIds": [3572],
"roleIds": [],
"includeSubDeparts": true
},
"tagIcon":{"icon":null,"iconColor":"qingorange","iconName":null}
}

返回

3.1 返回体
参数必含类型说明
errCodeint错误码,非0表示失败
errMsgstring错误描述
questionRelations关联的设置,这里没用
resultobject返回结果
tagIdint应用包id
3.2 返回体示例
{
"errCode": 0,
"errMsg": "ok",
"result": {
"tagId": 10637,
}
}
3.3 错误码相关

注意事项

1、请求参数中,dashIcon参数为应用包的图标,支持传入图片链接

  • 默认为橙色+首字,值为:{"icon":null,"iconColor":"qing-orange","iconName":null},效果如图:

文档图片

  • 图标底色(iconColor)/组件(iconName)可选值可参考

2、应用包名称不可更新为空字符串,否则将被更改为默认名称:未命名应用包