问题标签 [apiary]

For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.

0 投票
1 回答
815 浏览

jsonschema - MSON 指定日期时间

以下 MSON 如何输出具有“格式”:“日期时间”的模式,类似于下面所述?

女士:

获得的 Json Schema:

所需的模式(注意“格式”字段):

0 投票
1 回答
471 浏览

apiary.io - 如何格式化养蜂场蓝图的默认日期?

目前,我正在尝试使用以下格式修复以下 2 个警告。

我的警告是:

Specifying parameter 'start' as required supersedes its default value, declare the parameter as 'optional' to specify its default value.

Specifying parameter 'end' as required supersedes its default value, declare the parameter as 'optional' to specify its default value.

0 投票
1 回答
594 浏览

apiblueprint - 需要 Oauth 2.0 Authentication Scheme apiary apiblueprint 示例

我有一个使用 Azure Active Directory 和 OAuth 2.0 进行身份验证的 REST API。如何在 apiary 中使用 api 蓝图进行设置。

我可以看到它适用于http://docs.powerbi.apiary.io/

只是似乎找不到一个例子。

任何指针?

0 投票
1 回答
2560 浏览

api - 对象的蓝图数组(养蜂场)

我正在尝试使用基于此答案的语法来描述对象数组

但是养蜂场呈现的是

是bug还是我弄错了?

0 投票
1 回答
160 浏览

apiary - Apiary 可以在响应对象上创建锚点吗

我有一个请求,根据传入的参数返回不同的 200 个响应。我想直接链接到特定响应。响应的结构如下:

是否可以在回复中添加锚点,以便我可以直接链接到回复?

0 投票
2 回答
2297 浏览

image - 如何将图像/图表添加到 API 蓝图?

我们希望将图像集成到 Apiary 上的 API 文档中,作为记录底层应用程序架构或说明示例工作流/序列图的一种方式。然而,通过Apiary 文档API 蓝图规范进行搜索似乎并没有产生任何关于如何做到这一点的结果。

是否可以将图像添加到 API 蓝图?或者这些图像是否必须在外部托管并通过 URL 引用?

0 投票
1 回答
267 浏览

apiary.io - Dredd 似乎挂起对 asp.net kestrel 服务器的 api 调用

当我运行 dredd 时,它似乎只是在第一次 api 调用之后挂起。我不确定如何调试或诊断。我正在使用dnx web命令运行 asp.net 5 mvc 6 api 服务。我怎样才能看到正在发生的事情或问题可能是什么?

我尝试添加用于调试的钩子,发现它调用了第一个 api,然后就永远不会触发 after 事件。我用邮递员和 curl 测试了 api,结果正确。如果我使用的是 express node.js 服务器,Dredd 也可以使用相同的蓝图。

唯一失败的组合是 Dredd 与 asp.net kestrel 服务器响应。服务器记录发出请求并发送响应,因此它确实触发了测试,但永远不会完成。

Dredd 是否在寻找某种处理后挂钩,因为我看到服务器使用 dredd 接收请求,而不管 .net 或 node.js 是什么。即使我在另一个进程中启动 .net api 进程,它也不起作用,这有什么关系?无论如何,它应该只是对dredd的http请求,对吗?

它是否关心它从红隼服务器返回?

红隼反应

dredd.yml

dredd命令的控制台输出

测试.apib

0 投票
1 回答
557 浏览

rest - 更改 APIARY GET URL 参数以在内置 REST 客户端中进行测试

在 Apiary 中,我们使用http://baasar.apiary-mock.com/user/ {appId}/{userId} 其中 appId 和 userId 是 URL 参数。

Apiary 有一个内置的 REST 客户端,可以针对模型和生产 API 测试这些 API。

但是,尝试测试上述 API,如何在 Apiary REST 客户端中将 appId 和 userId 更改为真实的东西?

0 投票
1 回答
65 浏览

apiary - apiary REST 服务定义

我将 apiary 用于我的 REST 服务定义,并且我将响应一个请求参数 - 在底部的情况下,我将响应 {area} 请求参数。a.piary 编辑器中是否有任何语法可以执行此操作?({area} 和 $area 不起作用)

0 投票
1 回答
505 浏览

apiblueprint - 有没有办法发送空的可选查询参数?

我正在为 API 编写文档,但遇到了问题。

这是链接定义:

参数:

例如,当我尝试使用空hotels参数发送请求时,apiary 使用1844而不是空的。如果我尝试将其示例为空,hotels=hotels则发送。

有没有办法为可选参数发送空,或者根本不发送?

这是屏幕截图的链接: http ://www.awesomescreenshot.com/image/1008356/09614be501945b0644fd84a06e311404