API 标准即是数据标准

主要观点:除过去 20 年忽视技术趋势的人,其他人都了解并可能使用基于服务的架构,已发展到 API-First,围绕 API 合同展开,软件工程师应关注 API 实现方式以满足消费者对合同履行的需求,组织常定义 API 标准以提高 API 优先世界的成功机会,数据标准定义组织关键数据管理方法,包括命名、数据域、结构、验证等方面,API 和数据标准有相似性,组织应使两者标准一致以提高效率。
关键信息

  • API-First 中 API 是所有解决方案构建基础,先于其他开发工作实施。
  • 软件工程师关注 API 实现方式,消费者关心合同履行。
  • 组织定义 API 标准类似数据标准,以提高数据处理。
  • 数据标准包括命名、数据域、结构、验证等。
  • 以 GitHub 端点为例说明 API 和数据标准的相似性。
    重要细节
  • API 标准围绕合同,消费者不在乎实现细节。
  • 不同组织数据标准不同,无通用标准。
  • GitHub 端点示例中,URI 包含术语和数据,headers 声明 API 版本,request body 提供创建提交状态数据,response 显示标准应用,query parameters 用于数据检索过滤等。
  • API 和数据标准相似,应使两者一致以提高效率。
阅读 225
0 条评论