统一接口能力平台接口调用流程与环境

统一接口能力平台
接口调用流程与环境
1.背景介绍
统一接口能力平台是一个业务集成平台，它集成了一级客服系统、各省CRM系统及各省能力平台的业务能力，即接口API。

2.网络结构及平台所处的位置
3.术语
绑定：指客户通过自助渠道进行业务办理时，需要先进行第3方帐号与手机号进行关联，平台对关联关系数据进行维护。

绑定方
式有：手机号+随机码、手机号+密码
凭证：指用户访问系统的身份，不同的身份进行不同类别的接口调用。

凭证分3个级别：一般凭证、随机码凭证、服务密码凭证。

凭证级别权限划分：一般凭证、随机码凭证只能用于业务查询
类接口的调用，服务密码凭证用于业务办理类接口调用
4.接口分类
主要包含2大类接口：认证类、业务类（查询类、办理类）。

由于不同后端系统，认证机制不一样，所以平台提供的认证类接口、业务类接口是分系统的。

即，认证类与业务类接口要配套使用。

如：要使用一级客服的系统的话费查询接口，则先用一级客服的认证接口进行认证，而不能用其它系统的认证接口。

目前主要有省端系统、一级客服系统、商城能力开放平台系统。

省端系统是指各省的CRM及各省能力平台。

一级客服系统、商城能力开放平台是集团公司所提供的面向各省业务的系统。

5.业务接口调用要求
自助渠道：调用业务接口前，要求先进行帐号绑定、凭证申请。

帐号绑定只进行一次，凭证申请则需看有效期，如果在有
效期，则后续的业务接口调用就不用凭证申请了，如果失
效，但还想继续做业务接口调用的，需要再次发起凭证申
请。

人工渠道：调用业务接口前，要求先进行凭证申请。

申请后，且在有效期，则后续的业务接口调用就不用凭证申请了，如果失
效，但还想继续做业务接口调用的，需要再次发起凭证申
请。

6.接口使用逻辑流程
先看下面的流程图：
1.绑定接口调用：这一步是针对自助渠道要求的，绑定接口只需调
用一次，如果成功，平台会保存绑定数据，这样后续的业务
接口调用，就不用再调用绑定接口了。

绑定接口有2种绑定方式：随机码方式、服务密码方式。

接入渠道在使用时，可根据自己的业务需要进行选择。

随机码方式是指接入渠道先调用随机码生成接口，给用户手
机下发一条随机码短信，然后用户从前台录入随机码，接着
接入渠道在调用绑定接口时，把随机码作为绑定接口的入参
传过来，校验通过后绑定成功。

服务密码方式是指接入渠道把用户的服务密码作为绑定接口
的入参传过来，校验通过后绑定成功。

2.凭证申请接口：这一步是针对所有接入渠道的。

凭证是分级别，
且有有效期，对应的会有一般凭证申请接口、随机码凭证申
请接口、密码凭证申请接口。

有些系统会把这几种级别合并
在一个接口当中。

不同的级别可调用不同的接口。

一般是这
样划分的，查询类接口需要一般凭证，办理类接口需要服务
密码凭证。

3.业务接口调用：前2步做完，就可以进行业务接口调用了。

注意，不是每个业务接口调用都要调用前2步的接口。

7.开发流程
1.接到需求
2.需求分析与估算工时
3.需求资源提前申请（网络、数据库、对接数据及联调人等）
4.编写设计文档
5.程序开发
6.提交测试
7.上线
8.开发前准备事项
1.申请Git帐号
2.分配项目工程权限。