67得票6回答
在Markdown文件中,是否可以将表格居中显示?

我有一张表: | This | Is | A | Table | | :--- | -- | - | ----: | | foo | ba | r | elbaT | 我希望表格能够居中显示在我的Markdown文件中,而不是左对齐。 我不是想要对齐文本,而是整个表格本...

30得票1回答
如何使用Apiary记录多部分请求?

我想记录一个如下的多部分请求:Content-Length: 477 Content-Type: multipart/form-data; boundary=---BOUNDARY -----BOUNDARY Content-Disposition: form-data; name="ima...

22得票2回答
如何在同一端点上使用不同参数获得多个响应?

我们正在考虑使用API Blueprint。有些情况下,我们希望一个请求返回一个正确的响应,而另一个请求返回一个“错误”的响应,比如一个400 bad request,以便其他开发人员可以在apiary.io上使用模拟API,并处理它们的应用程序中的两种类型的响应。 下面是我创建的一个完全任...

18得票2回答
使用API Blueprint记录查询参数

我正在尝试在API Blueprint中记录一个查询参数,但我不完全确定我是否做得正确。该资源看起来像这样:DELETE http://baasar.apiary-mock.com/user/{appId}/{userId} 这个请求会停用用户,而下面这个请求会删除用户对象:DELETE ht...

16得票4回答
优秀的休息代码生成和文档工具

我一直在考虑一种文档工具,用于构建适用于多个客户端的后端Web服务,并支持OAuth和可能的多版本。我已经知道了Apiary,但是进行了一些调查后,我发现还有其他相当不错的解决方案,并且承诺很有吸引力。 RAML似乎提供了良好的代码生成和API可重用性。但它似乎无法创建模拟服务器。而且我不明...

14得票1回答
在Apiary中,表示输入参数为日期/时间的正确格式是什么?

我正在编辑我所在项目的一些Apiary文档,并需要标识其中一个API调用的参数为datetime字符串。由于Apiary似乎无法处理此参数的格式,因此我想知道在Apiary中记录此参数的建议方法。 为了演示,我使用了Apiary的标准默认文档,并修改了Choice文档以接受一个datetim...

12得票1回答
尝试使用数据结构在API Blueprint中描述请求和响应。

我正在尝试使用API Blueprint文档化一个端点,使用规范的新属性和数据结构部分。 我的请求负载看起来像这样:{ "url": "http://requestb.in/11v7i7e1", "active": true, "types": [ {...

11得票2回答
Apiary.io - 多个带有不同参数的响应(200)

我试图通过传递不同的参数获取不同的响应,但是有些东西没起作用。这是我的API:## Question [/questions/{question_id}] A Question object has the following attributes: + Parameters + ...

11得票1回答
为一对多关系暴露RESTful端点

考虑以下两个资源之间的关系: 学院有许多教职员工 教职员工隶属于一个学院 很明显,这里的教职员工不是一流资源。 现在我需要以下操作的终端点。 在该学院中创建一个新的教职员工。一种可能的方法是进行两个操作。 POST /faculties/ PUT /college/1/facu...

11得票2回答
如何在Apiary文档中指定错误代码?

我想指定在进行API调用时必须返回的各种异常/错误。如何使用Apiary实现这一点。