智能保险助手页面集成说明
1. 接入信息录入
进入【https://cii.tencent.cn/】通过腾讯云账号登陆,进入【页面集成申请】登记集成信息。Token地址对应OauthToken接口,UserInfo地址对应OauthUser接口。如果涉及到结构化/复核/核保异步通知,复核回调地址也需要登记。如果还不确定,登记可以不填,对接时候再更新。
2. OA集成,接入方需提供鉴权接口
核保结构化等页面集成需要账号打通。集成方需要提供OAuth相关接口,saas后端oauth验证成功后方可使用。以下接口仅供参考,具体接口需集成方提供。
2.1 OauthToken
授权码获取accesstoken的接口。授权码由集成方生成,建议结合
输入
字段名称 | type | desc |
---|---|---|
Code | string | 授权码。由集成方生成,建议生成策略结合openid生成,有有效期 |
GrantType | string | 固定为 authorization_code |
ClientId | string | 集成方提供 |
ClientSecret | string | 集成方提供 |
输出
字段名称 | type | desc |
---|---|---|
AccessToken | string | 登陆token |
Expire | string | 过期时间 |
RefreshToken | string | 用于刷新 Access Token 的 Refresh Token |
2.2 OauthUser
accesstoken获取用户信息
输入
字段名称 | type | desc |
---|---|---|
AccessToken | string | 登陆token |
输出
字段名称 | type | desc |
---|---|---|
UserName | string | 用户名 |
UserId | int | 用户唯一表示 |
3. 前端集成
3.1 对接环境/访问域名
访问域名(host):https://cii.tencent.cn/
3.2 iframe页面集成
页面名称 | 参数说明 | 接入地址(iframe src) |
---|---|---|
结构化复核 | structureMainTaskId: 结构化主任号code: GenerateCode生成openId: 开通企业服务生成 | https://{host}/tasks/{structureMainTaskId}/review?code={code}&openId={openId} |
结构化对比 | structureMainTaskId:结构化主任号code: GenerateCode生成openId:开通企业服务生成 | https://{host}/tasks/{structureMainTaskId}/compare?code={code}&openId={openId} |
核保复核 | underwriteTaskId: 核保任号code: GenerateCode生成openId: 开通企业服务生成 | https://{host}/underwrites/{underwriteTaskId}/review?operate=check&code={code}&openId={openId} |
4. 回调接口说明
4.1 结构化复核状态回调接口
接口地址
客户侧提供(HTTP+POST+JSON的方式)
请求参数
参数名称 | 类型 | 描述 |
---|---|---|
RequestId | String | 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
MainTaskId | String | 主任务ID,不重复且唯一 |
SubTaskId | String | 子任务ID,不重复且唯一,复核保存时提供 |
Status | String | 复核状态枚举Done/Doing/Saved |
请求示例
{
"Response":{
"RequestId":"22dfcc05-1ba1-49b4-a751-f5611cdb3420",
"MainTaskId":"Mshbylkq8buo",
"SubTaskId":"Sr5ifsludlhd",
"Status":"Done/Doing/Saved"
}
}
4.2 结构化结果回调接口
接口地址
客户侧提供(HTTP+POST+JSON的方式),创建任务时通过CallbackUrl参数传递
请求参数
参数名称 | 类型 | 描述 |
---|---|---|
RequestId | String | 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
MainTaskId | String | 主任务ID,不重复且唯一 |
Status | Integer | 结果状态:0:返回成功2:结果生成失败 |
Results | Set of ResultObject | 结构化识别结果数组,每个数组元素对应一个图片的结构化结果,顺序和输入参数的ImageList或FileList对应。 |
ResultObject
参数名称 | 类型 | 描述 |
---|---|---|
Code | Integer | 状态码:0代表成功;1代表结果为空;2代表下载结果失败 |
StructureResult | String | 由结构化算法结构化json转换的字符串,具体协议参见算法结构化结果协议 |
TaskType | String | 报告类型枚举 |
SubTaskId | String | 子任务ID |
TaskFiles | Array of String | 任务文件数组 |
请求示例
{
"Response":{
"RequestId":"22dfcc05-1ba1-49b4-a751-f5611cdb3420",
"MainTaskId":"asd23-25kd-dl234",
"Status":0,
"Results":[
{
"SubTaskId":"ssss",
"Code":0,
"StructureResult":"{\"abc\":\"123\"}",
"TaskType":"HealthReport",
"TaskFiles": [
"700000198392/original_upload_dir/700000198392_cba00b8e-4124-4ab3-8ae0-ab9d00583b3d.jpg"
]
},
{
"SubTaskId":"ssss2",
"Code":0,
"StructureResult":"{\"abcd\":\"123\"}",
"TaskType":"HealthReport",
"TaskFiles": [
"700000198392/original_upload_dir/700000198392_cba00b8e-4124-4ab3-8ae0-ab9d00583b3d.jpg"
]
}
]
}
}
4.3 核保结果回调
客户侧提供(HTTP+POST+JSON的方式),创建任务时通过CallbackUrl参数传递
请求参数
参数名称 | 类型 | 描述 |
---|---|---|
RequestId | String | 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
Uin | String | 主账号ID |
SubAccountUin | String | 操作人子账户ID |
PolicyId | String | 保单ID |
MainTaskId | String | 任务ID |
UnderwriteTaskId | String | 核保任务ID |
Status | Integer | 结果状态:0:返回成功1:结果未生成2:结果生成失败 |
ReviewType | String | MANUAL:手动复核MACHINE:机器结果 |
UnderwriteResults | Array of UnderwriteResult | 核保结果 |
UnderwriteResult
核保结果,包含多个用户的结果。当前只支持一个用户
名称 | 类型 | 描述 |
---|---|---|
CustomerId | String | 客户号 |
CustomerName | String | 客户名 |
MachineResult | Array of Object | 机器结论 |
输出示例
{
"Response": {
"RequestId": "asdfadasdfasdf",
"Uin": "123xxxxx",
"SubAccountUin": "123xxxxx",
"PolicyId": "123",
"MainTaskId": "Task-1",
"UnderwriteTaskId": "u-task-1",
"UnderwriteResults":[
{
"CustomerId": "user-1",
"CustomerName": "用户A",
"MachineResult": []
},
{
"CustomerId": "user-1",
"CustomerName": "用户A",
"MachineResult": [] // 详细示例见下方
}
]
}
}
MachineResult字段示例
[
{
"InsuranceType":"重疾险",
"Result":[
{
"Title":"AI决策",
"Conclusion":"承保",
"Explanation":[
{
"Name":"乳腺增生",
"Result":"承保",
"Value":""
}
],
"Disease":[],
"Laboratory":[]
},
{
"Title":"核保结论1",
"Conclusion":"承保",
"Explanation":"",
"Disease":[
{
"Name":"疾病风险指数",
"Result":"标体",
"Value":""
}
],
"Laboratory":[
{
"Name":"BMI",
"Result":"",
"Value":""
},
{
"Name":"低密度脂蛋白",
"Result":"低胆固醇血症",
"Value":"1.75"
},
{
"Name":"再保2化验指标风险指数",
"Result":"104",
"Value":"0"
},
{
"Name":"总胆固醇",
"Result":"-10",
"Value":"4.09"
}
]
},
{
"Title":"核保结论2",
"Conclusion":"承保",
"Explanation":[],
"Disease":[],
"Laboratory":[]
}
]
},
{
"InsuranceType":"寿险",
"Result":[
{
"Title":"AI决策",
"Conclusion":"",
"Explanation":[],
"Disease":[],
"Laboratory":[]
},
{
"Title":"核保结论1",
"Conclusion":"承保",
"Explanation":[],
"Disease":[],
"Laboratory":[]
},
{
"Title":"核保结论2",
"Conclusion":"承保",
"Explanation":[],
"Disease":[],
"Laboratory":[]
}
]
},
{
"InsuranceType":"意外险",
"Result":[
{
"Title":"AI决策",
"Conclusion":"",
"Explanation":[],
"Disease":[],
"Laboratory":[]
},
{
"Title":"核保结论1",
"Conclusion":"承保",
"Explanation":[],
"Disease":[],
"Laboratory":[]
},
{
"Title":"核保结论2",
"Conclusion":"承保",
"Explanation":[],
"Disease":[],
"Laboratory":[]
}
]
}
]
5. 页面在IE浏览器中集成方案说明
文档模式:document.documentMode
体现为 html meta tag: <meta http-equiv="X-UA-Compatible" content="IE=edge/11/10/9/8/7/6/5">
集成方式 | 客户页面文档模式 < 11 | 客户页面文档模式 >= 11 |
---|---|---|
iframe嵌入到客户当前页 | 不支持 | 支持 |
iframe嵌入到新标签页 | 可通过修改文档模式支持 | 支持 |
url打开新标签(暂未开放) | 不存在客户文档模式,由cii控制文档模式来支持 | 不存在客户文档模式,由cii控制文档模式来支持 |