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