Dataphin数据服务系列之--API 配置、管理和消费

研发小哥哥还在为公司里大量 API 只上不下,不可查不可用, 想找的 API 找不到而苦恼吗?业务方小姐姐还在为 API 开发时间长,业务相应不及时而抱怨吐槽吗? 铛铛铛,Dataphin 数据服务 -- API 配置管理,闪亮登场!助力研发小哥哥五分钟搞定 API,提升业务响应速度,同时大大提升 API 复用能力!

Dataphin 数据服务

Dataphin 是阿里巴巴数据中台(OneData - OneModel、OneID、OneService)方法论的产品载体。Dataphin 数据服务是其中 OneService 部分的载体,是 Dataphin 产品的组成部分,是数据中台的价值出口。连接数据和业务,主要解决数据最后一公里使用的问题。包括 API 管理、主题式即席查询等能力。本次主要为大家带来数据服务中 API 配置、管理、和使用的相关产品功能介绍~

API 配置 - 五分钟生成 API

配置生成主要有三大步骤:服务单元配置->API 配置->API 测试

服务单元配置

服务单元是数据服务产品中的概念,可以理解为一个逻辑表,可以是下挂单个物理表或下挂多个物理表,也可以是 Dataphin 逻辑表。配置人员根据需要选择字段,并进行字段的相关信息(字段名称和字段类型)配置。下图是单物理表服务单元截图。API 基于服务单元生成。服务单元跟 API 是一对多的关系。

目前数据源类型已支持:MySQL、ElasticSearch、AnalyticDB、HBase,8 月 30 即将支持 PostgreSQL、Oracle、MongoDB。更多数据源持续接入中。

API 配置

基于上文中配置好的服务单元,通过简单的 SQL 脚本,配置 API 的请求参数和返回参数,选择调用方法(支持 GET 和 LIST 两种调用方法),选择 API 更新频率配置,即可快速生成 API。配置界面如下图:

API 测试 

API 配置完成后,可以快速进行测试,通过配置请求参数,可以测试 API 的响应时间,以及返回内容详情,等。如下图:

API 管理 - 可上可下可维护

- API 上下线

在 API 管理界面,可以清晰的看到 API 的使用情况,被调用次数,发布更新时间,等。同时可以对新增 API 发布上线,也可以对已经存在的 API 下线和删除。让 API 的管理变得简单。

- API 监控运维 

API 生成后,可以进行 API 的监控和运维,包括 授权应用数、平均响应时长、调用次数、错误率、offline 百分比等指标的监控。 

API 消费 - 好找好拿

API 申请使用主要有三大步骤:API 服务市场查找->API申请和调试->API 使用

- API 服务市场查找

API 市场里包含了企业内所有已经发布的 API 信息,支持按分组查看,支持按 API 名称查找。可以在 API 市场里查看具体 API 的文档详情,也可以直接申请使用 API。

- API 申请调试

在上文 API 市场中,找到需要的 API 后,点击立即申请即可进入 API 的权限申请界面,入下图。数据服务中 API 的权限管理依托 Dataphin 的公共权限体系能力,做到了 API 字段级别的权限申请管控。当 API 申请通过后,在个人的后台,既可以看到申请通过的 API。通过配置 API 的入参,可以进行 API 调试,获取当前 API 的返回值,查看是否符合预期。API 调试界面可以对焦 API 测试界面,功能相同,多了 appkey 和 secret 传参。

- API 使用

数据服务提供了统一的调用 SDK,系统工程师可以在自己的系统中调用使用。

写在最后

经过上述简单的几步操作后,以往需要花几周的 API 在弹指一挥间就开发完成并在系统中成功使用上了~而且企业内的 API 管理变得轻松简单~从此,API 好找、好配、好管理~

结语:

阿里巴巴数据中台团队,致力于输出阿里云数据智能的最佳实践,助力每个企业建设自己的数据中台,进而共同实现新时代下的智能商业!

阿里巴巴数据中台解决方案,核心产品:

Dataphin,以阿里巴巴大数据核心方法论OneData为内核驱动,提供一站式数据构建与管理能力;
Quick BI,集阿里巴巴数据分析经验沉淀,提供一站式数据分析与展现能力;
Quick Audience,集阿里巴巴消费者洞察及营销经验,提供一站式人群圈选、洞察及营销投放能力,连接阿里巴巴商业,实现用户增长。

本文作者:张尘初

原文链接

本文为云栖社区原创内容,未经允许不得转载。

原文地址:https://www.cnblogs.com/zhaowei121/p/11907091.html