APIs.json 发现格式, API经济的潜在引擎.pdfVIP

APIs.j son 发现格式， API经济的潜在引擎 在API与微服务飞速发展的当今世界，如何在开发web或移动应⽤时、或者是对现有的 系 进⾏集成时找到最合适的API ，通常是⼀项乏味的任务。与之相对的是，许多API 提供者为了让他们所有的最有价值的、以API驱动的资源能够为潜在的调⽤者所发现 并⽅便地进⾏访问⽽绞尽脑汁。截⾄20 14年底，市场上所存在的API ⽬录也只有为数 不多的⼏个，API提供者能够在此列出他们的API ，⽽API调⽤者可以在此找到他们所 需的API 。虽然这种途径⽬前已经经过了⼀段时间的应⽤，但它是专门为了⼈类⽽设 计的，其它应⽤程序与系 ⽆法通过这种途径找到适合的API ，并根据他们调⽤的API 资源进⾏相应的决策， APIs.j son于20 14年5⽉发布 快速了解APIs.j son 基本APIs.j son指令集 APIs.j son⽂件的核⼼ —— API集合 APIs.j son 中最基本的构建块属性 不仅是⼀种发现格式 ⾃托管的发现能⼒ APIs.j son的⼯具 简单⽽强⼤的设计 关于作者 APIs.j son于2014年5⽉发布 在20 14年5⽉， 作为⼀家API管理基础设施提供者，3Scale与API Evangelist共同合作， 推出了⼀种机器可读的开放式API发现格式，名为APIs.j son 。APIs.j son的⽬标是提供 ⼀种简单⽽通⽤的格式，可⽤于对API 以及API运营的⽀持性元素进⾏索引。APIs.j son 的⼯作⽅式类似于Sitemap X L 的格式，但它的设计⽬的不是对⽹站进⾏索引，⽽是 对各种API进⾏索引，并将索引结果上传⾄⼀个众所周知的地点，API的提供者可以将 他们的API资源的索引发布在此。 APIs.j son的设计⽬标是为API提供者⼀个简单的⽅式以更新他们的API索引，同时也让 其它搜索引擎、⽬标与API服务提供者访问本地索引，让该领域中的API资源可被发 现。 快速了解APIs.j son APIs.j son的定义总是由⼀些基础信息的描述开始，⽤以表⽰API的作者，并将描述信 息放在⽂件的头信息中，这为调⽤者提供了关于API作者的⼀些描述参数，包括名 称、描述、图⽚、标签、创建⽇期、最后修改⽇期、以及该APIs.j son所发布的url 。 基本APIs.j son指令集 { name: API Evangelist, description: This is an inventory of APIs available as part o image: https://s3 amazonaws com/kinlane-productions/api-evang tags: [ application programming interface, API, News, Analysis ], created: 2014-04-07, modified: 2014-07-09, url: http://apievangelist com/*APIs json*, SpecificationVersion: 0 14, } 接下来是APIs.j son⽂件的核⼼部分，即API的集合。它让API提供者能够描述集合中的 ⼀个或多个API 。与头信息中的参数相似，每个API都可以设置⼏个参数，⽤以对每个 API进⾏描述，包括名称、描述、图⽚、标签、humanURL （⽤于让开发者进⾏访问， 以了解该API更多信息的url地址），以及baseURL （机器将通过访问这个基本url 以开 始使⽤该API ）。 APIs.j son⽂件的核⼼ —— API集合 apis: [ { name: Analysis, description: Provides access to blog posts and analysis a image: https://s3 amazonaws com/kinlane-productions/api-e human