Google公开了云服务API设计指南
Google公开了云服务API设计指南
2017-03-17 13:39:53 来源:36大数据抢沙发
2017-03-17 13:39:53 来源:36大数据
摘要:Google 公开了用于创建 HTTP 或 RPC API 的 API 设计指南。对于创建连接 Google Cloud Endpoints 的 gRPC API 的开发人员来说,这些设计原则更值得推荐使用。
关键词:
指南
云计算
Google 公开了用于创建 HTTP 或 RPC API 的 API 设计指南。对于创建连接 Google Cloud Endpoints 的 gRPC API 的开发人员来说,这些设计原则更值得推荐使用。
早在 2014 年,Google 在创建云服务 API 或其它服务 API 时就开始在内部使用了这些设计指南。指南中探讨了 HTTP 或 RPC API 的设计。虽然 HTTP API(也称为 REST API)的优点是公认的,但是它们距离实用尚有时日。Google 推荐 RPC 尤其是其变体 gRPC。据 Google 说,虽然大部分的因特网 API 是 HTTP,但是通常被云服务和服务提供商内部使用的是 RPC,并在数量上远高于 HTTP API。
对于通过方法操作一个或多个资源这样的场景,Google 推荐在设计 RPC API 时使用类 REST 方法。资源(也可称为域实体)使用 URI 表示,也可以在网络路径格式后面加上唯一的名称(ID)。同一类型的资源将组织成同一集合。
使用的标准方法包括Create、Delete、Get、List和Update。对于不能映射到任一标准方法上的操作,例如数据库事务,用户也可以创建自定义方法。推荐使用较少的方法来操作尽可能多的资源。
在创建资源时,推荐执行如下步骤:
确定 API 提供的资源类型。
确定资源间关系。
基于类型和关系确定资源的命名模式。
确定资源模式。
为资源附加最小的方法集。
Google 使用“语义化版本”标准命名版本,命名使用三个数字,形式为“主版本.次版本.补丁”。预发布版本在命名时添加了一个前缀,例如“1.0.0-alpha”。
对于资源、标准、自定义方法、标准域、错误、使用 proto3 创建 API 等方面,指南提供了更多细节和例子。
第三十五届CIO班招生
国际CIO认证培训
首席数据官(CDO)认证培训
责编:liuhan
免责声明:本网站(http://www.ciotimes.com/)内容主要来自原创、合作媒体供稿和第三方投稿,凡在本网站出现的信息,均仅供参考。本网站将尽力确保所提供信息的准确性及可靠性,但不保证有关资料的准确性及可靠性,读者在使用前请进一步核实,并对任何自主决定的行为负责。本网站对有关资料所引致的错误、不确或遗漏,概不负任何法律责任。
本网站刊载的所有内容(包括但不仅限文字、图片、LOGO、音频、视频、软件、程序等)版权归原作者所有。任何单位或个人认为本网站中的内容可能涉嫌侵犯其知识产权或存在不实内容时,请及时通知本站,予以删除。