api-design

32熱度

4回答

我有一個JSON REST API。有一個握手會給你一個有效15分鐘的令牌。您在15分鐘內完成的所有呼叫應該可以正常工作。 15分鐘後，我返回一個錯誤對象（包括代碼，消息，成功= false），但我也想知道應該返回什麼HTTP錯誤代碼？並且會使用HTTP錯誤代碼搞亂某些客戶端？（HTML5，iPhone，Android）。在這種情況下什麼被認爲是最佳實踐？

0熱度

1回答

具有多設備和瀏覽器功能的API設計

關於如何設計API以實現多設備（瀏覽器，手機等）的啓用功能，是否有任何指導原則。例如：在移動的情況下，考慮到屏幕空間和複雜性，我可能希望發送更少的數據用於相同的API調用等。欣賞關於此的任何輸入。

4熱度

1回答

Api設計：哪個更好：返回null爲空值或不爲空

我正在爲基於MongoDB數據存儲的Web應用程序設計我的第一個API。我返回json響應，我不知道如何決定，哪個更好：保持一致的響應方案，空字段或null。或僅返回非空值。這意味着舉例，當從我的Mongo數組中刪除值時，我需要檢查數組是否爲空，如果是，則$ unset它。

0熱度

2回答

的Python：如何使用類魔法啓用下列API

目的：鑑於這樣的： stackoverflow.users['55562'].questions.unanswered() 我想把它轉換成如下： http://api.stackoverflow.com/1.1/users/55562/questions/unanswered 我已經能夠實現這一目標，使用下面的類： class SO(object): def __init__

7熱度

2回答

在C中的公共API函數中使用枚舉參數是一個好主意嗎？

我正在設計一個C API，其中包括提供一些方法來設置一些雙值選項。爲了確定我用下面列舉的選項： typedef enum { OptionA, OptionB, ... } Option; 它是在一個公共的API函數使用Option作爲參數類型是一個好主意： int set_option(Option opt, double value); 或者是它更好地

2熱度

1回答

指示REST API中的實體 - 用戶關係

假設您正在設計Twitter REST API。有實體稱爲tweet s。用戶可以通過retweet和favorite這些推文。如果您要求tweet或帶有用戶身份驗證參數的推文聚合，您如何指示已通過身份驗證的用戶已經有retweeted和favorited這些推文而無需第二個API請求？目前，Twitter API在tweet實體上沒有這樣的字段，但它的官方客戶端和某些第三方客戶端能夠推斷出該推

0熱度

1回答

正在尋找類似於Facebook API中使用的唯一大型Int ID的東西

什麼是您希望爲系統中的每個唯一實體分配一個ID的企業體系結構的最佳實踐。而不是您想使用Big Int的GUID。有誰知道Facebook在內部爲了實現這個目標而做了什麼？在我的情況下，一些實體將在MySQL中，一些在MongoDB中，後來也許在Cassandra中。他們是否有一個「身份證」服務提供新的身份證？算法的方法？我正在尋找簡單，快速和可擴展的解決方案。

4熱度

2回答

（ab）使用CoClassAttribute爲接口提供默認實現可以嗎？

我最近發現可以通過裝飾與CoClassAttribute的接口來指定默認實現"new up" an interface in C#。 [ComImport, Guid("579A4F68-4E51-479A-A7AA-A4DDC4031F3F"), CoClass(typeof(FooImpl))] public interface IFoo { void Bar(); } p

2熱度

1回答

在規則處理的API中包含可變狀態

我有一個RuleTree數據結構，它表示用於處理傳入數據項的規則樹。 RuleTree是一個不可變的數據結構，它包含任意數量的（可能嵌套的）規則。有多個線程將同時將相同的RuleTree應用於不同的輸入數據項 RuleTree適用於輸入一個或多個階段的數據。由調用代碼決定應用哪個階段。典型的控制流程是這樣的： ruleTree.applyStage1(data); .. // other

2熱度

1回答

如何爲可選字段的案例類創建一個Java友好的API

我在Scala中創建了一些用於保存數據mongodb的案例類。客戶端應用程序是用Java編寫的，並通過傳遞這些案例類的實例來使用我的存儲庫。它正常工作，除非我用可選字段： case class Person (name: String, email: Option[String]) 從Java 現在我不想引用Scala的選項，所以我寧願重寫一個構造函數，允許客戶端調用的東西像 new Per