石岩朋吧 关注:28贴子:665
  • 13回复贴,共1

推荐一款神级 API 接口管理神器

只看楼主收藏回复

API 本质是一个封装了功能并公开一个用于访问功能的接口!关于API的信息外界无从得知,所以没有好的文档,使用者就无法理解和使用。API 文档最核心的需求是简洁精准,当然要是颜值再高一点那就更好了!
精准简洁的API文档可以推动研发数据规范化,降低协作成本,从而大幅度提高团队效率!最近总有阿里、腾讯、滴滴的开发朋友提到 ApiPost,自己体验操作后,发现它的优势的确明显。


IP属地:瑞典来自iPhone客户端1楼2022-01-10 17:06回复
    ApiPost 官方网站下载:
    网页链接 可以一键生成API文档,完全中文,界面简洁美观,而且免费使用!很适合国内的开发者使用。听说针对高校和培训机构还是完全免费的,无限工位,不限制任何功能。


    IP属地:瑞典来自iPhone客户端2楼2022-01-10 17:08
    回复
      怎么制作简洁精准的API文档?
      要有层次有结构
      API文档绝不只是简单直白的列出各种参数,好的文档应该是有层次有结构的内容,可以让使用者清晰理解。
      精准具象
      API本身就是抽象的,如果文档也是抽象的,对于使用者来说就是一场灾难了!可以多用实际案例,案例能显著减少理解成本。
      其次表达还要尽量精准,避免模糊的表达。


      IP属地:瑞典来自iPhone客户端3楼2022-01-10 17:08
      回复
        界面友好可搜索
        一个好的 API 文档,它的界面交互也要简单易用,尽量提供好的使用体验。以往的文档比较简单,现在的文档多是基于网页实现,可设计性很高,可以尝试多种设计方式。
        文档如果内容过多,在大量的代码函数中寻找目标会是一件非常费时的事。为使用者提供搜索功能,可以减少搜索相关内容的时间。


        IP属地:瑞典来自iPhone客户端4楼2022-01-10 17:08
        回复
          ApiPost 是什么?
          ApiPost是一个支持模拟POST、GET、PUT等常见HTTP请求,支持团队协作,并可直接生成并导出接口文档的API 文档、调试、Mock、测试一体化协作平台。
          简单说:
          ApiPost=Postman + Swagger + Mock + JMeter
          接口开发工作通常需要前端、后端、测试、技术经理等多个岗位协作,但因为流程长所以难管理,不同工具之间数据也缺乏统一规范,导致团队效率往往会很低下!


          IP属地:瑞典来自iPhone客户端5楼2022-01-10 17:08
          回复
            其次文档信息丰富学习成本低,功能齐全,用户在社区的提问反馈及时!
            在现在这样的敏捷开发年代,API研发越来越注重整个项目的协作,比如API调试、API文档,如果能贯穿整个研发流程,与项目所有角色打通,团队效率和效果都将大大提高!ApiPost就解决了这个问题。
            快速API调试


            IP属地:瑞典来自iPhone客户端7楼2022-01-10 17:09
            回复
              调试API的过程中有很多重复性的工作占据了大量的时间,比如一些参数(校验登陆的token)可能每个接口都会用到。没必要每个接口都设置一个这样的参数,最好的方式是放到全局参数里。
              ApiPost的全局参数、全局脚本、cookie管理、环境切换等功能可以减少大量重复性工作,让API调试效率大大提升!


              IP属地:瑞典来自iPhone客户端8楼2022-01-10 17:09
              回复
                快速生成接口文档
                国内对接口文档是非常重视的,有文档先行的理念,而国外对接口文档就没那么重视了。ApiPost的生成文档体验非常好,具体我们可以对比一下两个产品的生成接口文档的过程。
                Postman的生成接口文档要点击publish,然后生成设置页面,设置后才生成接口文档。


                IP属地:瑞典来自iPhone客户端9楼2022-01-10 17:09
                回复
                  多人实时协作
                  传统开发场景是分离的,协作效率很低,而在ApiPost前后端开发协作场景中,通过一份接口文档,就可以实现前后端并行开发:后台开发者把API托管在API网关上,使用ApiPost的mock功能模拟数据,利用API文档功能把API信息提供给前端同学,来实现前后端分离。
                  ApiPost有更本地化的协作功能,可以团队实时协作,团队成员新建接口同步在所有团队成员项目里。
                  比如锁定接口,除锁定者和管理员外,其他人均无法对其进行编辑、修改操作。


                  IP属地:瑞典来自iPhone客户端10楼2022-01-10 17:09
                  回复
                    还有很多协作方面的小功能,比如协作日志,归档管理、一键导入参数……
                    丰富的细节设计
                    ApiPost独创的参数描述库功能,解决了大量重复填写参数描述的问题!通常一个接口要调用多次,每次都要手动录入完全一致的描述,效率太低了!
                    ApiPost还可以自定义参数描述库,将项目用到的大量参数进行预注释,下次调用直接点选。如果你没有自定义描述库,第一次输入描述后也会自动加入描述库。


                    IP属地:瑞典来自iPhone客户端11楼2022-01-10 17:09
                    回复
                      类似的细节还有很多,这些细节设计据说都是产品在用户的反馈中总结而来,可以说正是这些细节让apipost成为最懂用户,最重视用户的产品!
                      最后,建议开发人员,包括后端、前端、测试朋友们都试试ApiPost,尤其是对后端开发朋友来说,这款工具实在太香了!


                      IP属地:瑞典来自iPhone客户端12楼2022-01-10 17:10
                      回复
                        编者按:本文为 FTX-中文Discord 第一次社群活动中嘉宾的发言整理,几位Web3的深耕者深入探讨了 Curve War、新公链竞争、L2争鸣、东方NFT崛起、VC范式转移等热点话题。
                        主持人:Sino Global Captial-Sally
                        嘉宾:GBV-Johnson;HashKey Capital-Rui;FTX 的台湾区社群合伙人-Benson;深潮 TechFlow 创始人-Min;Nothing Research-0xTodd;Smrti Labs-Bowen
                        直播地点:FTX-中文Discord:
                        Sally:Q1: 最近的Curve Wars带起了curve生态,包括CVX之战,DeFi未来格局还会如何“变”?甚至还有人说期待ve(NFT)的诞生,大家怎么看?


                        IP属地:瑞典13楼2022-01-14 23:46
                        回复
                          OxTodd: 我一直有个观点,Curve上各类项目的“神”。没有Curve的“神助”,这些锚定资产其实几乎没有任何生息的场景或者用途,而源源不断的$CRV奖励似乎成为了这些稳定币最重要的用途。
                          比如某M开头的稳定币,看下链上数据,不是存在Curve里,就是存在跨链桥里,然后跨到其他链存在其他链的Curve里。大家很快就意识到了——这个神仙奶妈产奶的速度是有限的。既然这样,就必须得有个方式来分配这些稀缺的资源,随之就有了Convex以及构建在Convex上的votium以及一系列贿选生态。贿选又维持了很长一段时间,杠杆率差不多是1:3,意思是如今1块钱贿赂可以撬动3快钱的CRV奖励。
                          但这个也开始进入比较卷的状态了。于是一些既得利益者开始考虑如何进一步将这些奶收入囊中。因此AC提出了ve(3,3),从他文章的字里行间中能够看出,他希望分奶的规则变得有倾向,例如用一个Locker来把所有$CRV奖励分给手续费最高的池子。但是去Curve看一下就知道,现在手续费最高的就是他亲自推动的$MIM…
                          因此,Curve生态的演化就是一个“分奶”问题,而这个话题一定是一个长期话题,只有长期下去,它才能不断进化出最完美的样子。而DeFi生态,在分奶层面目前基本都是比较初级,很多都是大锅饭制度。
                          因此,Curve的进化争论都是好事,长期来看,大家都要效仿Curve的DAO模型,这个要感谢他。我们之前投了一个项目izumi,它就吸收了一些$CRV的分奶技巧,我觉得挺有意义。
                          很期待未来,Curve也成为DAO治理和分奶层面的“神”。


                          IP属地:瑞典14楼2022-01-14 23:46
                          回复
                            Rui: 我理解中Curve产生治理之争的核心原因是稳定币Swap能带来稳定的低风险挖矿收益,争夺的是挖矿资金池的流动性,也就是低风险偏好的资金承担一定潜在的损失获取稳定收益。治理权很重要,但市场上除了Curve和很少的一部分Defi协议进化到需要抢夺治理权的阶段。关于未来方向,我是觉得基于aave和uni这两个沉淀了绝大多数底层资产的项目是有把锁仓资金的资金效率再次开发的潜力的。
                            对于aave之前有很多利率衍生品的尝试,但这些尝试都不是很成功,因为协议再精巧也没人用,因为太复杂了,这一块我看好把存贷利率再分配的项目和新的基于长尾资产的借贷项目。
                            然后是uni,uniV3是有能力的做市商的提款机,但是做市策略规模有限,没有必要开发出来给大家用。那么另一条路是通过期权衍生品做对冲,把LP资产通过crypto naitve的衍生品做成风险中性的挖矿产品或许是个不错的路径。
                            我觉得defi的底层资产再涨10倍按照目前的BTC ETH价格来说可能性不大,头部协议的地位也很难短时间动摇,但是再分配现有的底层资产产生的价值是非常有机会。


                            IP属地:瑞典15楼2022-01-14 23:46
                            回复