问题标签 [iodocs]

我正在尝试让 IODocs 在 Heroku 上运行。它需要 node.js 和 Redis。诚然，我对所有这些技术都是新手。尽管如此，我还是设法让它在本地运行。但是，我在部署到 Heroku 时收到以下错误。

我唯一一次收到关于本地交配的类似警告是在 Redis 未运行时。据我所知，Redis 插件已为我的应用程序启用并正在运行：

我也尝试了一些配置 建议。两者似乎都不起作用。

从我的Redis To Go调试行和Error的差异来看，我确信这是一个配置问题。但不知道如何解决。任何帮助是极大的赞赏。

我最初有这个问题，所以我尝试了

它似乎有效，只有一个警告：

但是当我尝试运行它时，它给了我：

我不知道该怎么办，请给我一些启发。

顺便说一句，我正在尝试在 Linux 2.6.35.14-97.44.amzn1.x86_64 EC2 实例上安装iodocs 。

============================更新====================== ===========================

我也尝试在Heroku上安装它，但遇到了同样的问题：

嗨，我已经在本地部署了 iodocs，并且它适用于给定的示例。但是对于我的 api，它给出了空的响应。

这是我附加到 /data/apiconfig.json 的内容

这是/data/cloudspokes.json

iodocs 正在正确呈现界面

还去http://cloudspokes.com/challenges.json返回非空响应。我是新手，请帮忙。

我们为项目内部使用设置了一个 Web API。我正在寻找一种记录我们 API 的好方法。我已经在网上搜索并找到了

• IO 文档
• 昂首阔步

这些工具读取可以自动创建的 JSON 文件，例如用于 Java。我们的 API 已经增长，我喜欢手动创建 JSON，而不是在文本编辑器中手动创建。是否有工具或前端可以减轻手动创建描述性 JSON 的负担？

另一方面，对于 Web API 的文档，有哪些值得推荐的工具？

Mashery iodocs是一个记录 API 的工具。它需要两个配置 json 对象才能运行。如果让美味派自动生成这些对象，那就太好了。Tastypie 可以生成带有 schema 的 json，但是它与 iodocs 的期望不兼容。关于如何使用美味派自动生成此配置的任何想法？

我正在使用 Mashery 的 iodocs 作为我的 REST API 的开发人员前端。我的 API 是用 Node / Express 编写的，并使用 PassportJS 对用户进行身份验证（本地策略）。我的实现要求用户使用 /login 端点，传入用户名和密码。然后，Passport 将用户序列化到一个 cookie 中，这样后续的请求就不需要登录了。

使用 iodocs 时，Passport 设置的 cookie（“connect.sid”）不会在后续请求中传回。

有没有办法做到这一点？IODocs 是否支持以这种方式工作的身份验证方法？

我有一个用烧瓶构建的 REST 网站，并使用其会话 cookie 功能来保持非常基本的“登录”（我不需要安全性）。

我正在尝试实现 iodocs 文档。“/login”工作正常，我还看到了发送 cookie 的响应，但我不知道如何告诉 iodocs 为下一次 API 调用保留该 cookie。

任何帮助（不需要我的网站更改为 OAuth）都会非常受欢迎。

我想在 JSON 字符串下面发布，作为 I/O DOC 中请求正文的一部分。

{"名称":"ABCD","别名":"PS","日期":"20140604","状态":"新建","PdfPath":"/folder1/app.pdf"}

端点的配置是什么？我正在使用以下端点配置，但它不起作用。

我有一些用普通的旧快递写的私人 api。是时候放出它并提供一些 api 文档了。

我不希望（至少现在）它重写我的快速应用程序以将 api 文档集成到代码中。主要是因为我不确定要使用什么框架或规范来记录我的 api，所以我真的不想锁定一件事。

我想将文档作为我的 api 下的子资源的一部分提供（即我不想运行不同的服务器或子域）。也许是'/api/docs'。一个加号也是我可以嵌入到我的应用程序中的 UI，它可以解析文档并至少提供一个很好的 html 文档演示（api 交互是一个加号）。

swagger-node之类的东西很酷，但需要我重新编写所有快速代码以集成 swagger。那时我有一笔巨额投资，而且我与 swagger 紧密相连。

有没有办法以对现有路线的侵入性最小的方式提供招摇或 iodocs 或其他东西来记录我的 api？

编辑：

我可以从手写文档中提供 Swagger 规范。我看到的问题是您必须basePath在 swagger 文档中定义。这并不能真正让我在不同的域下轻松部署。

Mashery IOdocs 是一个用于记录 API 的非常棒的工具。我将它用于一个相当大的项目，其中有 50 多个方法和复杂的结构发送到这个 API，所以我的 json 配置文件超过 4000 行。我在 VPS 上自行托管 IOdocs 以及其他东西，但由于我的 json 文件很长，所以文档速度非常慢。任何想法来应对这种延迟？除了显然将我的 json 配置文件分成几个。