7得票6回答
针对作用于数组的函数的API设计

我正在使用Java设计一个API,用于一组作用于double数组的数字算法(实时金融统计)。出于性能原因,API必须使用基本数据类型数组,因此List 等不是选项。 典型的使用案例可能是一个算法对象,它接受两个输入数组,并返回一个包含从两个输入计算出的结果的输出数组。 我想确立一致的约定,...

17得票2回答
HATEOAS链接与PUT/POST

什么是在资源上表示HATEOAS POST/PUT/PATCH的最佳方法?这些操作具有有效载荷,但我们没有选项将有效载荷表示为HATEOAS链接,因为它们不是预先确定的,可能很重。因此,仅指定端点并指定操作是否足够?关于带有HATEOAS POST/PUT/PATCH链接的JSON响应的任何示...

9得票1回答
适合用于PUT只读实体的HTTP状态

当客户端尝试PUT到一个当前只读的实体时,适当的HTTP响应代码是什么? 一个玩具示例是产品发货。在发货之前,可以更改详细信息(地址、产品、数量)(例如使用PUT请求)。然而,一旦发货,任何PUT都应该失败,即使请求格式和语法是正确的。 客户端可能不知道已经发货,因此这不是客户端方面的“粗...

12得票3回答
在Python中设计异步API

(注:此问题严格限于 API 的设计,不涉及如何实现它;即我只关心我的 API 的客户端在这里看到什么,而不是我必须做什么才能使它正常工作。) 简单来说:我想知道 Python 中 显式 future(又名 promises、deferreds、tasks——名称取决于框架)的已建立模式(如...

8得票4回答
在RESTful API中,DELETE调用应该是递归的吗?

假设我有以下关系型数据结构(举个例子): (for example sake): A `post` which is a child of a `category` 这些API端点可以访问这些数据: GET /category/1 GET /category/1/post/1 GE...

9得票2回答
Web API设计技巧

我目前正在开发一个非常简单的网络服务,考虑编写一个API,这样当我决定在新平台上扩展它时,只需要编写解析器应用程序。也就是说,该API并不是为其他开发人员而设计的,而是为了我自己,但我不会限制对其的访问,因此任何人都可以在此基础上构建。 然后我想甚至可以通过这个API运行网站本身,出于各种原...

11得票4回答
自然键和RESTful URL

我正在设计一个RESTful API,其中所有资源都使用数字主键。然而,一种类型的资源具有方便的自然键,我希望能够使用它作为指定单个资源的可选方式。为了保持一致性,所有资源都将通过其主键访问。 目前为止,我可以这样做(假设23是主键):mysite.com/api/v0/sites/23/ ...

9得票1回答
C API应该返回值还是错误码?

我正在编写我的第一个C语言库,但不确定该如何进行。例如,从某个数据存储中检索字符串值的函数可以如下所示: int get_value(void * store, char ** result); 或者 char * get_value(void * store, int * error...

29得票4回答
RESTful API路由设计:嵌套与非嵌套的区别

我的问题是在构建API URL时,嵌套资源的优势。考虑以下两种访问员工资源的替代方案:/api/employees?department=1 # flat Vs. /api/departments/1/employees # nested 现在考虑开发一个通用库,用于访问 API 中...

13得票1回答
为什么我们需要EPOLLRDHUP,而EPOLLHUP似乎已经足够了?

根据Linux man页面, EPOLLHUP 当从管道或流套接字等通道读取时,此事件仅表示对端关闭了其通道的一端。 EPOLLRDHUP 流套接字对等方关闭连接或关闭了连接的写半部分。 我几乎看不出EPOLLHUP和EPOLLRDHUP之间的任何区别。 对我来说,每当使用EPOLLR...