接口开放平台，我的一些思考

1. 概述

接口开放平台，为访问者提供统一的URL作为唯一访问入口，参数中指定具体接口标识和接口参数。它的优点包括接口规范性、效率、管理能力。接口开放平台可以分为简单的和复杂的两种方式。简单的接口开放平台，由自身提供接口实现。复杂的接口开放平台，为其他业务系统提供开放API的能力。

简单的接口开放平台

复杂的接口开放平台

接下来从三个部分阐述我对接口开放平台的理解。 

2. 鉴权

• 接口调用方标识，由平台分配
• 令牌，由平台分配，用于生成签名
• 根据接口调用方标识进行接口权限和限制控制

3. 接口映射

接口名称映射关系

列举需要关注的关系信息

开放接口标识，例如规范 业务.模块.行为

映射接口类型，例如HTTP、具体RPC类型

接口描述，例如URL

HTTP方法类型，如GET

接口参数映射关系

列举需要关注的关系信息

数据的层次结构

类型转换

验证要求

4. 支持接口种类

针对复杂的接口开放平台，需要考虑支持哪些形式的接口。

内部接口

• 开放平台系统提供的接口，例如使用easyOpen框架定义的接口
• 适用于小型开放平台，映射关系简单，系统内部维护了接口标识与bean method的关系。

外部接口

    开放平台系统为其他业务线提供开放API能力。重点在于如何调用外部接口。外部接口是HTTP形式的话，这是比较容易处理的。外部接口若是某种RPC类型，就比较麻烦。有的公司，业务系统各自为战，选型和注册中心都不同，这种情况下，在开放平台里面维护各种业务系统的服务发现和API包就会很麻烦。有的公司，使用同一套RPC框架，这样的话，服务发现不用单独维护，但是API包的维护是个麻烦。这时候，就需要RPC框架支持泛化调用，不需要开放平台维护服务发现和API包。