开发实践

开放平台根据案例总结出一套最佳开发实践，第三方公司可以结合它梳理自身开发流程。

开始开发之前，请阅读开放平台的 "OPENAPI 文档"，提前熟悉一下"接口规范"、"回调规则"、"公共参数"等章节内容。

我们以安卓开发为例，梳理一下整体开发步骤。

为了更方便的集成安卓SDK，我们准备了DEMO项目。以安卓为例，DEMO请参考 "安卓SDK Demo项目码云地址"。SDK Demo App截图如下所示：

• 第一步：获取平台访问凭证，请参考开放平台OPENAPI "获取平台访问凭证"

• 第二步：获取检测项目列表，请参考开放平台OPENAPI "获取检测项目列表"

• 第三步：创建开放平台检测单，请参考开放平台OPENAPI "创建开放平台检测单"

完成以上三步之后，就可以通过安卓SDK调起检测页面：

如上图所示，完成检测单之后，后续还有一些任务需要完成：

1. 接收检测报告回调

在开放平台的后台管理页面中，用品牌商账号登录后，可以设置回调地址(此功能默认关闭，请联系开放平台技术支持开启)。

第三方公司可以调用开放平台的"获取车辆检测报告" 接口查询车辆检测报告，也可以通过接收开放平台的回调(请参考接口"创建接车订单回调")，自行展示H5报告地址或者根据json内容定制自己的检测报告内容。

2. 车况&保养计划回调

生成检测报告之后，不仅仅会通过第三方公司设置的回调地址，进行检测报告的回调，还会进行车况问题及保养计划的回调。请参考开放平台OPENAPI接口"车况&保养计划回调"。第三方公司可以对完整车况问题清单与保养计划结果数据进行二次开发。

需要注意的是，车况&保养计划回调，仅仅执行一次。如果保养计划在开放平台有更新，目前不会触发二次回调。

3. 大屏APP定制

生成检测报告之后，门店技师可以使用大屏APP，和车主分析检测报告。在此过程中，第三方公司可以设置大屏一些个性化属性，比如按钮是否展示。

在大屏APP中，在点击推荐服务的时候，默认会弹出开放平台的商品导购信息。第三方公司可能希望使用自己的商品信息完成整个导购流程。开放平台提供了H5链接的形式，如下图所示：