V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
ch3rub1m
V2EX  ›  程序员

因为工作需要,业余时间和几个同事一起翻译了一下 Google API Design Guide,有需要的可以来看看。

  •  
  •   ch3rub1m · 2018-06-14 16:52:31 +08:00 · 2937 次点击
    这是一个创建于 2336 天前的主题,其中的信息可能已经有所发展或是发生改变。

    API 设计规范一直是个让人很头痛的问题,不同的设计风格会导致同一个公司之间无论是前端浏览器还是后端服务调用不同的实现时产生很多不可预知的情况,维护成本和理解成本还很高。

    题主以前是 Rails 开发者,因此对于 API 设计一直倾向于面向资源、标准化方法。 但是在真实的业务场景下,也有很多难以抽象的业务。

    无意间看到 Google 的 API Design Guide,发现里面提出了很多比较建设性的观点。网上搜了一下,没有翻译得比较好的版本,因此利用业务时间和几个同事一起把它翻译了,本次翻译经过了两轮翻译,并最后核对,尽量做到了信达雅。

    除了可以在公司内部推广以外,也是对自己的 API 设计风格的总结。

    目前应该完善得差不多了,因此决定开源,有兴趣的可以看看,顺便麻烦点个 Star。

    GitHub Repo: https://github.com/ch3rub1m/api-design-guide

    Gibook 在线文档: https://google-cloud.gitbook.io/api-design-guide/

    谢谢大家。

    9 条回复    2018-06-14 22:25:21 +08:00
    zynlp
        1
    zynlp  
       2018-06-14 17:25:44 +08:00 via iPhone
    刚好最近在学习 rpc,支持一个
    my3157
        2
    my3157  
       2018-06-14 19:36:06 +08:00
    已 star
    sulinehk
        3
    sulinehk  
       2018-06-14 19:47:06 +08:00 via Android
    mark
    somebody
        4
    somebody  
       2018-06-14 19:48:21 +08:00 via Android
    已 star,建议把帖子里的话整理一下,发在 github 的 readme 里,另外还有原始链接
    ch3rub1m
        5
    ch3rub1m  
    OP
       2018-06-14 21:49:26 +08:00
    @zynlp 谢谢,最近 gRPC 写得比较多,这个 design guide 里也有不少针对 gRPC 的内容,等我再熟悉一些的时候打算写一个 gRPC 的教程
    ch3rub1m
        6
    ch3rub1m  
    OP
       2018-06-14 21:49:48 +08:00
    @my3157
    @sulinehk
    感谢
    ch3rub1m
        7
    ch3rub1m  
    OP
       2018-06-14 21:51:16 +08:00
    @somebody 嗯,谢谢建议。这个 Readme 其实是谷歌官方的 Introduction 翻译过来的,我之后会把它放进 Introduction 章节,然后在新的 Readme 里放上原文链接
    nVoxel
        8
    nVoxel  
       2018-06-14 22:23:16 +08:00 via Android
    好!
    Ge4Los
        9
    Ge4Los  
       2018-06-14 22:25:21 +08:00
    非常不错,之前是翻看的英文版。
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   3769 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 53ms · UTC 10:27 · PVG 18:27 · LAX 02:27 · JFK 05:27
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.