開發人員團隊是否有Web服務（API）標準或最佳實踐？

Question

如果您要開始爲您的Web應用程序開發API。有什麼樣的指導方針，最佳實踐或標準來構建Web服務。我已經在這個主題上看到了一些討論，我想獲得更多信息。

至少得到哪裏獲取信息的指針。

在此先感謝。

Answer 1

API 101

我粘貼此URL作爲可能的答案非常近似。由於我沒有得到任何其他答案，我認爲這是儘可能接近。

我希望有更多的細節最佳實踐大綱，如果有人找到更好的東西，讓我知道標記他們的答案被接受。

Answer 2

關於「網絡服務」存在廣泛的範圍和寬容度。我發現它有用做什麼，我們正在談論的明確注：

web = transported over HTTP(S) 
service = remote procedure call (RPC) 

注意，這樣做的HTTP（S）部分僅規定了傳輸介質，而不是內容。還要注意，這個RPC部分僅僅指定了行爲（實質上是遠程調用一個帶有返回結果的參數的命名函數）而不是內容。

出現的一個關鍵問題是您是否控制通信的雙方。如果是這樣，但特別是如果不是，則需要關注互操作性。

SOAP是實現Web服務的標準，該服務爲請求和響應的內容指定了使用特定格式的XML。這是非常沉重的，並且跨各種實現的互操作性仍然存在問題。

有很多自定義實現，其中大部分更輕，但幾乎肯定會有互操作性問題。由於任何形式的內容都可能用於實現Web服務，因此我建議您選擇能夠處理複雜內容（不同程度），標準化，輕量級和強大的內容。

我最近傾向於JSON的內容格式。我建議考慮一樣，特別是如果你正在考慮實施AJAX。

祝福。

Answer 3

如果你可以回答其中的一些問題，你可能會得到更滿意的答案。

1. 誰將會消費該服務的觀衆？
2. 什麼類型的客戶端技術將消耗服務
3. 你可以對他們設置什麼假設/限制（平臺，工具，技能 集）？
4. 你的API有多廣泛 - 它會暴露多少種方法？
5. 安全是一個考慮因素 - 您需要保持多少安全？
6. 您是否需要支持交易？