获取用户常用应用
适用版本>=v7.0.2412b.20241226
接口说明:获取用户常用应用
请求说明
| 请求地址 | 配置域名+/openapi+/v7/get_workbench_favorite_apps |
|---|---|
| 请求方法 | GET |
| 签名方式 | KSO-1(配置域名+/openapi不参与签名) |
| 权限要求 | 查询应用信息(用户授权) kso.app.read |
请求头(Header)
| Header | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| Content-Type | string | 是 | 使用 application/json |
| X-Kso-Date | string | 是 | RFC1123 格式的日期,例: Wed, 23 Jan 2013 06:43:08 GMT |
| X-Kso-Authorization | string | 是 | KSO-1 签名值,详见《签名方法》 |
| Authorization | string | 是 | 授权凭证,格式为:Bearer {access_token} |
查询参数(Query)
| 名称 | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| page_token | string | 否 | 分页标记 |
| page_size | integer | 是 | 分页大小 |
响应体(Response)
| 名称 | 类型 | 说明 |
|---|---|---|
| code | integer | 响应结果标识 |
| msg | string | 错误信息描述 |
| data | object | 响应数据 |
| ∟ next_page_token | string | 分页标记(365 规范) |
| ∟ items | array | 应用数据 |
| ∟ ∟ id | string | 应用id |
| ∟ ∟ name | string | 应用名称 |
| ∟ ∟ type | string | 官方应用(official)、企业自建应用(company_internal)、ISV应用(isv) |
| ∟ ∟ description | string | 应用描述 |
| ∟ ∟ logo | string | 应用图标 (返回的是一个url) |
| ∟ ∟ i18n | array | 国际化 |
| ∟ ∟ ∟ lang_code | string | 语言类型:繁体中文,英文,日文,泰文。("zh-TW","en-US", "ja-JP" ,"th-TH" ) |
| ∟ ∟ ∟ name | string | 应用名称 |
| ∟ ∟ ∟ description | string | 应用描述 |
| ∟ ∟ settings | array | 应用设置 |
| ∟ ∟ ∟ single_item | object | 字符串类型的应用设置 |
| ∟ ∟ ∟ ∟ key | string | pc_xz_homepage_open (pc端打开模式); pc_xz_homepage(pc端主页); mobile_xz_homepage(移动端主页) |
| ∟ ∟ ∟ ∟ value | string | pc端打开模式: app, external_browser; url |
| ∟ ∟ category | array | 应用分组 |
| ∟ ∟ ∟ name | string | 应用分组名称 |
| ∟ ∟ ∟ id | string | 应用分组id |
响应体示例
json
{
"data": {
"items": [
{
"category": null,
"description": "打卡",
"i18n": [
{
"description": "",
"lang_code": "zh-TW",
"name": ""
},
{
"description": "",
"lang_code": "en-US",
"name": ""
},
{
"description": "",
"lang_code": "ja-JP",
"name": ""
},
{
"description": "",
"lang_code": "th-TH",
"name": ""
}
],
"id": "woa-attendance-assistant",
"logo": "DD1AFB29d29hL2M3ZmQ4OWI3YTQyZDc0NGJlNWI0YTNkZWNhMjY2YmRhOndwczM6d29hOjE=",
"name": "打卡",
"settings": [
{
"single_item": {
"key": "pc_xz_homepage_open",
"val": "app"
}
},
{
"single_item": {
"key": "pc_xz_homepage",
"val": ""
}
},
{
"single_item": {
"key": "mobile_xz_homepage",
"val": ""
}
}
],
"type": "official"
}
]
},
"msg": "成功",
"code": 0
}