API本質上是封裝和抽象功能的、并且只公開一個用于訪問該功能的介面,API開發人員常常沒有意識到其中有多少功能沒有公開,這會讓使用者無法更好的理解、使用API,
如果發布的API難以集成、不遵循任何標準或不適當的標準,則開發人員使用該系統會非常吃力,確定要使用哪種API標準非常重要,因為每種標準都針對特定的受眾,如果需要支持最大數量的用戶,可以使用一個非常簡單的、不需要太多開銷的API標準,例如RESTful API,REST標準相當寬松,最好的方法是各個API之間保持一致,

遵循用于身份驗證的通用API標準(例如OpenID,OAuth和SAML)可以使開發人員和非開發人員客戶更容易地使用API,但是,如果不為用戶處理身份驗證,請使用更簡單的基于HTTP或基于令牌的身份驗證,而不是主要用于身份驗證的OpenID,OAuth或SAML,
此外,提供一個可記錄自身資訊的API檔案,對開發人員來說是有益的,它可以讓開發人員快速的了解API的作用,例如您可以將API規范等資訊保存在Eolinker中,Eolinker是一個統一介面管理平臺,可快速匯入API并生成API檔案,當API檔案完善后,還需要圍繞它們進行一些良好的測驗,
使用地址:www.eolinker.com


如果你想讓你的API易于使用和理解,你真的必須把它檔案化,當API檔案規范化且有較高的可讀性,則API管理會變得更加簡單,并大大提高作業效率,

轉載請註明出處,本文鏈接:https://www.uj5u.com/qita/227259.html
標籤:其他
上一篇:掌握生產中API管理的工具和技術
