橙讯开放平台基线
首页服务端API客户端API附录橙讯官网
首页服务端API客户端API附录橙讯官网
  1. 工作台卡片
  • 开发前准备
  • 组织自建应用对接
    • 获取访问凭证
      • 获取访问凭证
    • 单点登录
      • 概述
      • 应用单点登录
      • 管理员单点登录
    • 消息推送
      • 概述
      • 消息推送
      • 消息撤回
    • 通讯录同步
      • 概述
      • 获取通讯录
        • 获取全量通讯录
        • 获取增量通讯录
      • 回调通知
        • 回调通知说明
    • 机器人
      • 概述
      • 创建群
      • 更新群
      • 查询群信息
      • 解散群
      • 设置群公告
      • 查询机器人创建的群列表
      • 发送群消息
      • 给指定用户发送消息
    • 待办
      • 概述
      • 创建待办
      • 更新待办
      • 删除待办
      • 更新待办执行人
    • 待阅
      • 概述
      • 创建待阅
      • 更新待阅
      • 删除待阅
      • 更新待阅执行人
    • 工作台卡片
      • 概述
      • 添加应用卡片模板
        PUT
      • 获取应用的卡片模板列表
        GET
      • 更新应用卡片模板
        POST
      • 删除应用卡片模板
        DELETE
      • 设置卡片组织级数据
        POST
      • 批量设置卡片数据(卡片数据不同)
        POST
      • 批量设置卡片数据(卡片数据相同)
        POST
    • 错误码
      • 错误码
  • 组织服务对接
    • 组织服务对接准备
    • 对接流程
      • 概述
      • 换取企业永久授权码
      • 获取访问凭证
      • 获取全量通讯录
      • 获取增量通讯录变更
      • 更新通讯录
    • 错误码
      • 错误码
  • 历史版本(不推荐)
    • 组织自建应用对接
      • 通讯录同步
        • 概述
        • 获取通讯录
          • 获取全量通讯录
          • 获取增量通讯录
        • 回调通知
          • 回调通知说明
      • 消息推送
        • 概述
        • 消息推送
  1. 工作台卡片

设置卡片组织级数据

POST
/apps/v1/card/set-enterprise-data
设置应用卡片组织级数据,生效范围为指定的组织成员,适用于应用卡片针对指定组织展现相同卡片数据的场景

请求参数

Authorization
Query 参数
access_token
string 
必需
Header 参数
User-Agent
string 
可选
默认值:
CX
Body 参数application/json
replace_user_data
boolean 
是否覆盖用户工作台卡片数据
可选
默认为false, 如果为true 为选择覆盖用户数据,企业该信息将会覆盖企业信息时间点之前的用户信息,如果不填或者为false 则不覆盖
默认值:
false
type
enum<string> 
卡片数据类型
必需
对应卡片模板类型 目前支持LIST 和 KEYDATA
枚举值:
KEYDATALISTIMAGEWEBVIEW
data
object 
数据实体
必需
默认数据类型和type对应
type = LIST 时 数据格式如下:
{
"items":[ //最多能包括3组数据
{
"text":"智慧校园新版设计的小程序要来啦", //长度最多100
"jump_url":"http://jump_url", //长度最多300
"action":"action", //长度最多300
"timestamp":0L //时间戳 (null 为不显示 ,0 为1970-01-01)
},
{
"text":"智慧校园新版设计的小程序要来啦",
"jump_url":"http://jump_url",
"action":"action",
"timestamp":0L //时间戳
}
]
}
当type = KEYDATA 为
{
"items":[ //最多4组数据
{
"key":"最大访问人数", //最大长度20
"data":"20", //最大长度20
"jump_url":"http://jump_url", // 最大长度300
"action":"action" //最大长度300
},
{
"key":"最大访问人数", //最大长度20
"data":"20", // 最大长度20
"jump_url":"http://jump_url", // 最大长度300
"action":"action" // 最大长度300
}
]
}
当type = IMAGE 时 (暂不支持该类型)
{
"url":"xxxx",
"jump_url":"http://jump_url",
"action":"action
}
当type = WEBVIEW时 (暂不支持该类型)
{
"url":"http://jump_url",
"jump_url":"http://jump_url",
"action":"action
"height":"single_row",
"hide_title":true,
"enable_webview_click":true
}
示例
{
    "replace_user_data": "false",
    "type": "KEYDATA",
    "data": {}
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://service.cheng-xun.cn/api/apps/v1/card/set-enterprise-data?access_token' \
--header 'User-Agent: CX' \
--header 'Content-Type: application/json' \
--data-raw '{
    "replace_user_data": "false",
    "type": "KEYDATA",
    "data": {}
}'

返回响应

🟢200成功
application/json
Body
err_code
integer 
可选
err_msg
string 
可选
默认值:
ErrorCode.SUCCESS.getErrMsg()
示例
{
    "err_code": 0,
    "err_msg": ""
}
修改于 2025-04-01 02:36:03
上一页
删除应用卡片模板
下一页
批量设置卡片数据(卡片数据不同)
Built with