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

批量设置卡片数据(卡片数据相同)

POST
/apps/v1/card/batch-set-same-data
批量设置用户卡片数据,适用于针对不同用户设置相同的卡片业务数据

请求参数

Authorization
Query 参数
access_token
string 
必需
Header 参数
User-Agent
string 
可选
默认值:
CX
Body 参数application/json
enterprise_id
string 
展示的组织id
可选
show_on_all_enterprise为true可不填
show_on_all_enterprise
boolean 
是否全组织展示该数据
必需
对应下列account_id 的所有组织可见(如果一个用户有多个组织)
account_id_list
array[string]
用户列表
必需
对应用户account_id 列表,最多支持200个用户
>= 1 items<= 200 items
type
enum<string> 
卡片数据类型
必需
对应卡片模板类型 目前支持LIST 和 KEYDATA
枚举值:
KEYDATALISTIMAGEWEBVIEW
data
object (Object) 
卡片数据
必需
默认数据类型和type对应
type = LIST 时 数据格式如下:
{
"items":[ 最多能包括3组数据
{
"text":"智慧校园新版设计的小程序要来啦", 长度最多100
"jump_url":"http://jump_url", 长度最多300
"action":"action", 长度最多300
"timestamp":0L //时间戳
},
{
"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
}
err_code
null 
可选
err_msg
null 
可选
示例
{
    "enterprise_id": "string",
    "show_on_all_enterprise": true,
    "account_id_list": [
        "string"
    ],
    "type": "KEYDATA",
    "data": {
        "err_code": null,
        "err_msg": null
    }
}

示例代码

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/batch-set-same-data?access_token' \
--header 'User-Agent: CX' \
--header 'Content-Type: application/json' \
--data-raw '{
    "enterprise_id": "string",
    "show_on_all_enterprise": true,
    "account_id_list": [
        "string"
    ],
    "type": "KEYDATA",
    "data": {
        "err_code": null,
        "err_msg": null
    }
}'

返回响应

🟢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