有奖捉虫:办公协同&微信生态&物联网文档专题 HOT
文档中心 > 智能保险助手 > API 文档 > 智能保险助手页面集成说明

智能保险助手页面集成说明

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控制文档模式来支持