How do I convert Swagger JSON to RAML/YAML and validate it? I am not looking for a programmatic way, just a one off conversion.

I have RAML schema which contains "javaType": "java.util.Map<String, java.util.List<Employee>>" I have separate schema (employee.schema) available which represent class Employee. But ...

Question: how can I split swagger definition across files? What are the possibilities in that area? The question details are described below: example of what I want - in RAML I do have experience...

I am unable to find any code anywhere that demonstrates using a !include for multiple examples. I'm trying to attempt the following: 200: description: Successful project creation body: applicat...

I have a generic Java type like this: class Response<D> { List<D> data; } and want to create something similar with RAML 1.0 (where I am new to). My first approach was types: Res...

Our api will have a reusable /posts subroute that will apply to different top-level routes. For example: /me/posts /users/{user-id}/posts ... Example for posts: /posts /{post-id} /like...

Somebody knows if is there a version of raml2html to Raml 1.0? I found only tools for Raml 0.8, like raml2html or raml2md, but doesn't working for Raml 1.0.

I'm writing some REST documentation with RAML but I'm stuck. My problem: - I have a GET request used for search that can take a parameter "id" or (exclusive or) "reference". Having only one of th...

I'd like to ask if there is any support for POST parameters in RAML. And if there is - what is the syntax. I've browsed spec 0.8 and spec 1.0 roughly (actually I'm bound to 0.8, since many tools do...

We recently decided to use RAML to document our API and all seems great so far. We are using the raml2html utility to generate static HTML documentation. The default template works great, but I've...

1) When writing RAML, can I use nesting in my schema definition? For example: schemas: - DNSResponse: | { "type": "object", "properties": { "AnswerSection": { "type": "array", "items": (((...

Is there a way to exclude one or more properties from a request body when you use a type and writing your API using RAML 1.0 I'll explain. I have a type: 'Order' with a set of properties. I have a...

We have a form which has a long paragraph for a scienctific application that contains characters like symbol beta(ß-arrestin) etc. We have a JSON service running on Mule that takes the data and per...

I have been considering a documentation tool for building a backend for a web service to be used in multiple clients along with OAuth and possibility of multiple revisions. I already knew abo...

If I have a file defining a Datatype SimpleDuple, and in another file defining another datatype called DiscreetFilter I want to have a property values to be an array of SimpleDuple how would I use ...

I am loving how RAML can dynamically reference different schemas when declaring a resourceType like: resourceTypes: - collection: get: responses: 200: body: application/json: schema: <&l...

Where I can find the Facebook API in a format like http://swagger.io, https://apiblueprint.org or http://raml.org? I want to read and request the facebook server (api) "half-atomatic". My script k...

Just getting started with raml (read the spec) to see if it has what I need to document my api. Concerned about required baseUri property at root level to define you server Url. I am in a scenari...

I'm declaring a REST service API stub in RAML. My web application provides equipment, which can be listed, obtained by id or by code. When I want the whole list, I don't specify any URI parameter, ...

I would like to edit RAML on Eclipse. I didn´t found any Eclipse plugin to RAML. On RAML website (http://raml.org/projects.html) there is only to Sublime. Do you know an option to have a gr...

I'm want to use RAML to describe an API using OAuth2 Does anyone have a solution or example I could use to compare with my own RAML for my api?