新建API流程归纳

下图是在数据服务平台上创建API并进行API申请的基本流程图:

使用流程归纳 - 图1

对于不同的角色可选择不同的模块创建API或者直接申请API使用。

API开发者:
对于API开发者,需要选择具体的数据源、表、配置请求参数和返回参数,正确配置API的取数逻辑,对API进行测试,API测试成功后即可发布API;

API调用者:
对于API调用者,可以在API集市查看详情,支持申请API,支持新创建应用,生成appkey和Secert,同时下载操作文档,正确调用API。

新建API基本流程:

  1. 登记数据源;
  2. 创建API集合;
  3. 新建API,选择创建的API类型,包括新建API、注册API、服务编排和标签画像API(只有在包含标签画像产品且版本在3.7.0+才支持该类型);
  4. 配置API基本信息:包括协议、请求方式、返回类型和设置超时时间等;
  5. 配置API参数:根据选择不同的API类型,配置界面不一样,比如选择新建API,则需要配置请求参数和返回参数,包括参数名称、类型和描述等;
  6. 保存和测试:在线发送请求,显示请求详情和返回内容;
  7. 发布API:测试成功的API才可以进行发布;
  8. 绑定应用:处于发布状态的API才可以授权应用。

API类型

数据服务平台支持基于数据库表生成API的新建API类型、将第三方API注册至平台的注册API类型、使用条件节点或python、UDF等对API进行业务逻辑处理的服务编排类型以及将标签画像数据生成API的类型(只有在包含标签画像产品且版本在3.7.0+才支持该类型)。

使用流程归纳 - 图2

新建API

数据服务平台支持将数据库表通过新建API的方式生成API,支持MySQL、HBase、Redis、MongoDB等多种数据源类型的API构建。

注册API

平台支持将已有的API通过注册功能,统一由数据服务平台进行管理。

注意: 在使用注册API功能时,需要先通过数据源登记功能,将已有的API登记进元数据中心,以便于在注册功能中选择已登记好的API。

API注册整体流程如下:

  1. 登记API数据源类型;
  2. 创建API集合;
  3. 在API列表选择注册API功能;
  4. 配置API基本信息:包括API名称、协议、返回类型、设置超时时间等;
  5. 配置API参数:选择已注册的API数据源,添加请求参数和响应示例;
  6. 保存和测试:在线发送请求,测试注册API的连通性和返回内容;
  7. 发布API:测试成功的API才可以进行发布;
  8. 绑定应用:处于发布状态的API才可以授权应用。

对于新建API和注册API,API创建成功之后,后续的操作过程雷同,都需要绑定应用,通过应用鉴权调用,也可以发布后在API集市申请使用。

新建服务编排

服务编排API是可以基于画布,通过托拉拽的方式定义查询工作流,支持API节点、脚本节点(支持python 2.7,用于数据处理)、条件节点(支持python2.7,用于工作流分支控制)和UDF节点,完成复杂的API业务逻辑处理,比如完成异构数据源的关联查询、条件取数等较为复杂的流程。

新建标签画像API

标签画像API的类型只有在包含"标签画像"产品且版本为3.7.0+才支持。支持将标签画像侧的标签和群组数据以API的方式开放出去,更好的对接上游应用系统,完成标签从开发到应用的闭环流程。

更多有关新建API的详细信息,可查看新建API和注册API服务编排标签画像API章节