招商观众导入检查
1. 接口描述
接口名称：
/eventopenapi/event/whitelist/cmbchina/import/check
发送方式：
POST
参数格式：
accept: application/json;content-type: application/json
说明：
对招商观众名单进行结构化导入前校验。校验通过后返回
batchId，再调用「招商观众导入激活」接口完成正式导入。单次最多支持 10000 条。
2. 输入参数
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| token | String | 是 | 统一鉴权token |
| eventId | Long | 是 | 直播会议ID |
| append | Boolean | 是 | 是否增量追加。true: 增量追加；false: 全量替换 |
| audiences | Array | 是 | 待导入观众列表（不能超过10000条） |
audiences 参数说明
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| employeeId | Long | 是 | 招商工号 |
| name | String | 是 | 观众姓名 |
3. 输出参数
| 参数 | 类型 | 说明 |
|---|---|---|
| timeStamp | Long | 返回时间（时间戳，单位毫秒） |
| requestId | String | 请求ID（在接口异常时, 需提供请求ID） |
| code | Int | 返回的状态码。200: 全部校验通过；14864: 部分数据校验失败 |
| msg | String | 当返回结果的状态码不为200时，包含的错误信息 |
| data | Json | 返回数据 |
data 参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| totalCount | Long | 总条数 |
| validCount | Long | 校验通过条数 |
| failedCount | Long | 校验失败条数 |
| batchId | String | 批次ID。校验通过后，用于后续「招商观众导入激活」接口 |
| errors | Array | 校验失败明细列表（无失败时可为空） |
errors 参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| row | Int | 失败数据行号（从1开始） |
| name | String | 观众姓名 |
| employeeId | String | 招商工号 |
| error | Array | 失败原因列表 |
4. 示例
输入示例
{
"token": "5d41c4ac806c6440eb6aa8e071115f2b",
"eventId": 542818,
"append": false,
"audiences": [
{
"employeeId": 10001,
"name": "张三"
},
{
"employeeId": 10002,
"name": "李四"
}
]
}
输出示例（全部校验通过）
{
"timeStamp": 1762770000000,
"code": 200,
"msg": "Successfully to check the internal whitelist!",
"data": {
"totalCount": 2,
"validCount": 2,
"failedCount": 0,
"batchId": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"errors": []
},
"requestId": "10.255.0.106_20261110_164116_1762770000000"
}
输出示例（部分数据校验失败）
{
"timeStamp": 1762770000000,
"code": 14864,
"msg": "part data is invalid",
"data": {
"totalCount": 2,
"validCount": 1,
"failedCount": 1,
"batchId": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"errors": [
{
"row": 2,
"name": "李四",
"employeeId": "10002",
"error": [
"employeeId is invalid"
]
}
]
},
"requestId": "10.255.0.106_20261110_164116_1762770000000"
}
