apiary.io

0热度

1回答

所以我们可以说我有一个200响应哪个机构应该是： { "data": [ { "id": 1, "title": "Activity 1" }, { "id": 1, "title": "Activity 2" } ] } 我设法通过API使用它来获取响应主体的这种行为蓝图。 + Re

2热度

2回答

任何尺寸的Dredd/apiary/MSON数组

我们正在努力在我们的API中描述任意大小的数组。使用API Blueprint和MSON格式进行Dredd测试。端点/点应返回一个“点”（这些是对象）的数组。我们不知道有多少。目前我们只能使dredd验证阵列的第一个位置。这里是我们的蓝图： FORMAT: 1A HOST: http://host.com/ # Our API ## Spots [/spots{?type}]

0热度

1回答

API蓝图（例如：蜂房） - 工具从蓝图

生成JSON的身体是否有一个工具从API蓝图语法使得例如JSON机构帮助？例如，如果我已经制定了这样的属性： + Attributes (object) + data (array) + (object) + id: 100 (number) - The ID for the particular EPG object + title: "Vik

0热度

2回答

API蓝图：语义问题

在我的蓝图，我定义的数据结构，并尝试使用它像在文档的末尾，以便 + Attributes + error: (Error Details, required) 数据结构定义“没有指定值（S）”： # Data Structures ## Error Details + code : 1234 (number, required) - see list of error cod

3热度

1回答

在Apiary.io的API蓝图中使用通用命名类型

如何在我的API蓝图定义中使用generic named type？我尝试这样的： FORMAT: 1A HOST: http://test.com/ # API Blueprint testing. ## Resource [/resources] ### Action [GET] + Response 200 (application/json) + Attribu

0热度

1回答

apiary.io作为非托管解决方案提供吗？

可以将apiary.io作为纯粹的私有内部部署解决方案使用，而不是提供托管解决方案吗？

0热度

1回答

API蓝图 - 使用数据结构作为响应，无属性

我正在使用Apiary模拟出一个新的API。我试图避免一遍又一遍地写出所有的JSON响应。如果我使用+ Attributes(user)这样做，那么它会在机器面板中自动生成一堆属性块，这在我的脑海中是非常令人困惑的（特别是当您有多个响应时）。如果您手动输出JSON请求/响应块，则生成的文档看起来会更好。有没有办法将请求/响应对象存储为数据结构？也许是一个模型？我很想能够做到这样的事情： #

4热度

2回答

API蓝图 - 避免重复授权块

在API蓝图中，我该如何避免对每个端点反复使用相同的请求授权标题块？ + Request (application/json) + Headers Authorization: Bearer jsonWebToken 有没有办法在数据结构中模拟这个呢？

4热度

1回答

如何在Swagger中为内容类型：text/html的Response Body提供示例值

我有一个响应200 OK并返回HTML的API调用。我想将其添加到我的API文档（特别是因为我使用dredd进行了验证，除非我提供它与期望的响应正文测试失败）。如何我会在Swagger中做到这一点？ ---更多细节--- 我通过API调用的响应是200 OK，并有一行响应体： <html><body>You are being <a href="https://my.domain.com/us

1热度

1回答

如果我在URL中指定API版本，我是否应该提供一个选项以将它放在标题中？

我设计我的API，我在URL GET /Issuer/{certificate-name}/versions?api-version=2016-10-01[&maxresults] 我也应该有一个在HTTP标头（灵活性）指定指定一个可选的API版本？如果两种方法之间存在冲突，我该怎么办？