APIs.guru加入了越來越多的API索引

責任編輯:editor004

作者:Benjamin Young

2016-06-17 11:51:18

摘自:INFOQ

APIs guru是最新的獲取API定義索引、內容管理和空間發(fā)現的方法。APIs guru正在進入一個持續(xù)擁擠的市場,其中還有別的API索引網站

APIs.guru是最新的獲取API定義索引、內容管理和空間發(fā)現的方法。

這個開源的(MIT許可證下)社區(qū)現在正在管理包括236種API描述的索引,其中覆蓋了6271個端點。APIs.guru致力于變成“REST API中的維基百科”。

APIs.guru正在進入一個持續(xù)擁擠的市場,其中還有別的API索引網站,包括The API Stack、API Commons、APIs.io、AnyAPI和更老的索引例如ProgrammableWeb's API Directory。這些API索引都有一個共同的目標,APIEvangelist.com的博客主Kin Lane說道:

全世界的開發(fā)者都在他們的工作中使用這些定義,并且現代化的API工具和服務提供商也在使用它們定義自己需要展示的內容。為了幫助API行業(yè)達到下一個層次的目標,我們需要你走近并且與API Stack、APIs.io或APIs.guru分享你擁有的API定義,并且如果你有時間和能力,我們希望您也能幫助我們一起為現在能使用的受歡迎的服務整合其他新的API定義。

APIs.guru的目錄主要是由它的創(chuàng)造者Ivan Goncharov在管理。據一個DataFire博客的入口中說,最初版本的目錄的構建方式是“使用自動抓取和人工管理相結合的方式來爬取網絡中可用計算機處理的API定義”。

而這些提交與下面的評估標準不符:

過濾掉私有的或者不可信賴的API 將不同的格式轉換到統(tǒng)一的OpenAPI(fka Swagger)2.0格式 修正錯誤,其中約80%的說明有一些錯誤 加入額外的數據,例如:logo、種類等 每日對一些說明定義進行更新

這個索引本身可以通過GitHub Pages中一個獨立的JSON文件看到:https://api.apis.guru/v2/list.json

這個文件包含了一個JSON對象,其中的格式將API的ID作為鍵:[:]。每個API描述的內容都包含:描述是什么時候加入的,現在推薦使用的API版本是什么,以及它的服務在OpenAPI文檔中的鏈接(之前它以Swagger的名字為人熟知)。還有一個相對自由的格式叫做info對象,其中包含了基本的標題和描述信息,連同x-*鍵存放不同API提供者的具體信息。

除API索引之外的東西可以通過一個添加API的頁面獲取到,其中在GitHub上的APIs-guru/api-models庫中開放了一個問題。一旦添加,提及的API說明定義就會從提交的格式(RAML、API Blueprint、WADL等)被轉化到OpenAPI 2.0的格式。最后,一個日常腳本會運行,來監(jiān)控源API定義的更新。

查看英文原文:APIs.guru Joins Growing List of API Indexes

鏈接已復制,快去分享吧

企業(yè)網版權所有?2010-2024 京ICP備09108050號-6京公網安備 11010502049343號