本文档介绍应用场景集成服务的完整接入流程,帮助您快速完成从需求评估到正式上线的全过程。
在开始接入前,请确认以下信息:
| 确认项 | 说明 |
|---|---|
| 对接方式 | API / H5 / SDK(三选一或组合) |
| 应用场景 | PC端 / 公众号 / APP / 小程序 / 管理后台 |
| 保司范围 | 需要对接的保险公司列表 |
| 业务险种 | 车险 / 寿险 / 非车险 |
| 数据交互需求 | 是否需要保单数据自动同步 |
请根据对接方式准备相应材料:
通用材料:
API对接额外材料:
H5/小程序对接额外材料:
SDK对接额外材料:
方式一:在线申请
访问开放平台官网,填写接入申请表单,提交后1个工作日内会有专属顾问联系您。
方式二:电话咨询
拨打技术支持热线,直接与技术顾问沟通需求。
方式三:在线咨询
通过开放平台在线客服,实时沟通接入方案。
专属顾问将与您沟通以下内容:
需求确认后,您将获得:
技术支持团队将为您建立专属对接群,包含:
根据您的需求,技术支持工程师将提供:
API对接方案:
H5对接方案:
SDK对接方案:
您将获得测试环境账号,包含:
API对接:
# 测试环境API地址示例
https://api-test.example.com/v1
# 鉴权Header示例
Authorization: Bearer {access_token}
H5对接:
<!-- H5页面嵌入示例 -->
<iframe src="https://h5-test.example.com/quote?app_key=YOUR_APP_KEY&user_id=12345"></iframe>
SDK对接:
// Android SDK依赖示例
dependencies {
implementation 'com.example:scene-integration-sdk:1.0.0'
}
根据对接方式,完成以下核心接口对接:
必接接口(API对接):
| 接口名称 | 功能说明 | 优先级 |
|---|---|---|
| 获取AccessToken | 获取接口调用凭证 | ⭐⭐⭐ |
| 续保查询 | 查询车辆续保信息 | ⭐⭐⭐ |
| 报价接口 | 获取保险公司报价 | ⭐⭐⭐ |
| 核保接口 | 提交核保申请 | ⭐⭐⭐ |
| 支付接口 | 发起支付请求 | ⭐⭐⭐ |
| 出单接口 | 确认出单 | ⭐⭐⭐ |
| 回调通知 | 接收交易状态变更通知 | ⭐⭐⭐ |
必接功能(H5/SDK对接):
| 功能模块 | 功能说明 | 优先级 |
|---|---|---|
| 用户登录 | 用户身份验证 | ⭐⭐⭐ |
| 续保查询 | 输入车牌查询续保 | ⭐⭐⭐ |
| 报价展示 | 展示多家保司报价 | ⭐⭐⭐ |
| 方案对比 | 对比不同保司方案 | ⭐⭐ |
| 核保提交 | 提交核保信息 | ⭐⭐⭐ |
| 在线支付 | 完成保费支付 | ⭐⭐⭐ |
| 出单结果 | 展示出单结果 | ⭐⭐⭐ |
如需对接数据交互平台,额外完成以下步骤:
在测试环境中完成以下测试:
基础功能测试:
| 测试项 | 测试内容 | 预期结果 |
|---|---|---|
| 续保查询 | 输入测试车牌号,查询续保信息 | 成功返回续保信息 |
| 报价测试 | 发起报价请求,获取保司报价 | 成功返回多家保司报价 |
| 核保测试 | 提交核保信息 | 核保通过或返回核保意见 |
| 支付测试 | 使用测试支付账号完成支付 | 支付成功,返回支付凭证 |
| 出单测试 | 确认出单 | 出单成功,返回保单号 |
异常场景测试:
| 测试项 | 测试内容 | 预期结果 |
|---|---|---|
| 网络异常 | 模拟网络中断 | 有重试机制或友好提示 |
| 保司接口异常 | 模拟保司接口不可用 | 有降级方案或友好提示 |
| 支付失败 | 模拟支付失败场景 | 返回失败原因,支持重新支付 |
| 并发测试 | 模拟高并发场景 | 系统稳定,响应正常 |
验证回调通知功能:
测试完成后,提交测试报告,包含:
测试验证通过后,申请生产环境账号:
API对接:
# 生产环境API地址
https://api.example.com/v1
# 生产环境AppKey和AppSecret
# 请从技术支持获取
H5对接:
<!-- 生产环境H5地址 -->
<iframe src="https://h5.example.com/quote?app_key=PROD_APP_KEY&user_id=12345"></iframe>
SDK对接:
// 生产环境SDK配置
// 请在初始化时配置生产环境参数
在生产环境中进行冒烟测试:
技术检查清单:
业务检查清单:
建议采用灰度发布策略:
第一阶段: 内部测试(1-2天)
第二阶段: 小范围灰度(3-5天)
第三阶段: 全量发布
灰度验证通过后,正式全量上线:
技术监控:
| 监控项 | 监控内容 | 告警阈值 |
|---|---|---|
| 接口可用性 | API接口响应成功率 | < 99% |
| 接口响应时间 | API接口平均响应时间 | > 3秒 |
| 交易成功率 | 报价→支付→出单转化率 | < 80% |
| 回调通知成功率 | 回调通知送达成功率 | < 99% |
业务监控:
| 监控项 | 监控内容 | 关注点 |
|---|---|---|
| 出单量 | 每日出单量趋势 | 异常波动 |
| 保司占比 | 各保司出单占比 | 保司偏好 |
| 转化率 | 报价→出单转化率 | 优化空间 |
| 客诉量 | 用户投诉数量 | 服务质量 |
定期查看数据报表:
根据监控和数据分析结果,持续优化:
A1: 可以通过以下方式获取帮助:
A2:
A3: 提供7×24小时技术支持,包括:
最后更新:2026-07-02
文档版本:v1.0