Tag: raml

提供Node / JS REST API的文档: 我正在寻找使用Node和Express构buildREST API，并且希望为它提供文档。我不想手工制作，看起来有Swagger，RAML和Api Blueprint / Apiary等forms的解决scheme。我真正喜欢的就是使用Swabbuckle或者微软提供的解决scheme，尽可能在.NET中使用API代码自动生成文档，但是通过强大的input和reflection使得它们成为可能。对于JS世界来说，正确的select是使用Swagger / RAML / Api Blueprint标记来定义API，然后从中生成文档和脚手架服务器。前者看似简单，但我对后者不太确定。我所见过的所有这些选项的服务器代码生成看起来都非常有限。需要有一些方法来将自动生成的代码与手动代码分开，以便定义可以很容易地更新，而且我也没有看到任何迹象或讨论。这似乎不是一个不可逾越的问题（我比.NET更熟悉.NET，所以我可以很容易地错过了一些东西），并提到这个问题和解决scheme正在从以前的堆栈溢出问题一年前。任何人都可以告诉我，如果我失踪/误解任何东西，如果有解决上述问题的存在？

鱼鹰RAMLvalidationerror handling: 我正在尝试自定义处理由于RAML规范失败发送给调用者的响应。目前我的代码执行以下操作。 const cfg = require("./cfg"); const log = require('./logging'); const RAML = require('osprey'); const startMessage = "My Service started on port " + cfg.SERVER_PORT + " at " + cfg.API_MOUNT_POINT; // start an express server const start = x => { // server dependencies const fs = require('fs'), express = require('express'), app = express(), […]