zoukankan      html  css  js  c++  java
  • 使用Eolinker可以帮助记录API

    开发人员体验是常规用户体验的扩展,它强调了开发人员在使用API方面的体验。良好的API开发人员经验不仅仅局限于技术范围,还需提供所有正确的资源,帮助最终消费者成功地集成和使用您的API。

    文档的作用

    精心设计的开发人员体验以API文档为中心。 API文档是成功使用和集成API所需的信息。这将采用技术写作,代码示例和示例的形式,更好地理解如何使用API。简洁明了的文档,使API使用者可以快速将其采用到他们的应用程序中,对于想要推动其API采用的团队而言,不再是可选的。

    记录好的文档不是一件容易的事

    对于许多API团队而言,文档编制仍然是一项繁琐且耗时的任务。对于依赖静态文档的团队而言尤其如此,这些文档随着API新版本新版本的发布进行手动更新。 但是,记录API的方式也发生了一些重大变化。这些变化最明显的莫过于API描述格式的广泛采用。 比如Eolinker,Eolinker允许开发人员和团队设计,构建,记录和使用RESTful Web服务。Eolinker得到如此广泛采用的最大原因之一是能够生成交互式文档。该文档使任何人(无论是开发团队还是最终用户)都可以在不使用任何实现逻辑的情况下可视化API资源并与之交互。 这些自动生成的文档是开发团队可以自定义的核心资源,并在此基础上创建用于使用API的更全面的用户手册。

    使用Eolinker

    无论是Eolinker的新手,还是已经在使用Eolinker进行API设计的人,很有可能对如何改进API文档存有疑问。创建API用户希望喜欢的API文档需要花费一些时间,但是这项投资将以巨大的开发经验,更轻松的实现和更好地采用API的形式带来可观的回报。想要了解更多请访问:www.eolinker.com

  • 相关阅读:
    史上最全Java表单验证封装类
    QQ组件可导致IE10无响应
    如何获取特定用户组内的无效账户?
    IN2Windows 8 (Part 2)
    IN2Windows 8 (Part 4) 文件历史记录功能及其重置方法
    IN2Windows 8 (Part 3)
    Android 多文件监听的实现
    Android 调用打电话,发短信(彩信),发邮件,浏览器,分享,跳转系统的各个设置页面
    Android中Drawable小结
    Android 加载.gif格式图片
  • 原文地址:https://www.cnblogs.com/dc20181010/p/14648532.html
Copyright © 2011-2022 走看看