Stack Overflow
Stack Overflow

Questions tagged [raml]

RESTful API Modeling Language (RAML)

RESTful API Modeling Language (RAML, http://raml.org/) is a simple and succinct way of describing practically-RESTful APIs. It encourages reuse, enables discovery and pattern-sharing, and aims for merit-based emergence of best practices. The goal is to help our current API ecosystem by solving immediate problems and then encourage ever-better API patterns. RAML is built on broadly-used standards such as YAML and JSON and is a non-proprietary, vendor-neutral open spec.

RESTful API Modeling Language (RAML) makes it easy to manage the whole API lifecycle from design to sharing. It's concise - you only write what you need to define - and reusable. It is machine readable API design that is actually human friendly.

369 questions
0
votes
1 answer

raml 1.0 response types

I am trying to build a RAML documentation (v 1.0) and I am stuck it seams at the very first stages. I have the vendor resource, I defined as follows: types: Vendor: type: object properties: name: string …
Victor Radu
  • 2,262
  • 1
  • 12
  • 18
0
votes
1 answer

Example for the RAML file in Anypoint studio

I currently follow this tutorial: https://docs.mulesoft.com/anypoint-platform-for-apis/creating-an-apikit-project-with-maven but I have a problem in creating the RAML file I don't know how to do this and I have to take the information from these two…
Rajeun
  • 721
  • 2
  • 12
  • 37
0
votes
1 answer

Automatic JAX-RX to RAML

I have written web services of my Java project using resteasy. For the documentation process i want these web services to be captured using RAML. For this I am able to find an eclipse plugin of RAML that will generate a .raml file. But we have to do…
Loui
  • 533
  • 17
  • 33
0
votes
1 answer

RAML validation throws 'Invalid value type'

I try to validate linkedin.raml but I got below set of validation errors for some reason. [2015-10-07 00:09:46,776] ERROR {org.wso2.carbon.registry.custom.extensions.handlers.utils.RAMLProcessor} - Invalid value type [2015-10-07 00:09:46,778] …
tk_
  • 16,415
  • 8
  • 80
  • 90
0
votes
1 answer

Documenting multiple POST request for OAUTH under same resource RAML

I realize that the title might be a little bit confusing so here is what I am trying to achieve: I need to document token_grant and token_refresh methods using RAML both of which are POST calls. token_grant: generate the first time OAuth token…
sinanspd
  • 2,589
  • 3
  • 19
  • 37
0
votes
1 answer

Running raml2html inside an ANT script

I have some RAML files sitting in a folder, and I'm setting up an ANT script to "build" them into HTML documentation using the raml2html package featured on the raml.org site. I'm new to ANT, so I'm probably not making the most efficient use of it,…
Ubunfu
  • 1,083
  • 2
  • 10
  • 21
0
votes
1 answer

Mule ESB - Retrieve URL HTTP Request from file

I'm using Mule since 1 week. I already managed to connect to a HTTP REST request, using Quartz to trigger the events every tot minutes. My request gives me back an XML or a JSON. Now, I need to do the same but to retrieve the url, to which connect,…
Chiara
  • 11
  • 1
0
votes
2 answers

Call rest service that returns JSON in mule esb?

How to call a rest service that returns JSON in a APIKit based message flow. I want to prepare the request for Rest service and want to extract the JSON message in a message flow. Can any one help me to do this? Thanks
user1627100
  • 41
  • 1
  • 2
  • 4
0
votes
3 answers

How to get message from RAML in a Mule message flow

I have created a flow in anypoint studio and using a raml file for invoking REST API. In this particular case I want to get the exact value of respective field specified in my RAML file. E.g. In the message flow I want to get the exact value like…
user1627100
  • 41
  • 1
  • 2
  • 4
0
votes
1 answer

Expose RAML contract instead WADL in CXF

I am new in REST world, an in most of CXF examples that I saw there is an configuration to expose WADL in REST services when published. Something like Available RESTful services: Endpoint address: http://localhost:8080/ouat-servicesImpl/api WADL :…
arthurfnsc
  • 915
  • 3
  • 13
  • 30
0
votes
1 answer

Description of post methods with RAML and REST

I'm using RAML to specify my REST contracts and I would like to know if is some way to better write the contract in POST methods. Actually my POST methods show me this informations:
arthurfnsc
  • 915
  • 3
  • 13
  • 30
0
votes
1 answer

RAML how to document nested params

How to document nested parameters (no matter query or body) with RAML? For example: { "credentials: { "login": "some-login", "key": "some-key" } }
Sebastian
  • 2,618
  • 3
  • 25
  • 32
0
votes
1 answer

What properties of an item should be included in the json schema?

I am confused about for which situation I am defining the properties in my json schemas. Assume I have an item product for which I am trying to define a schema. In my database the products table has id, brand_id, name, item_number and description.…
Esben
  • 1,943
  • 1
  • 18
  • 37
0
votes
3 answers

Java or JavaScript library to generate HTML from Swagger, RAML or API Blueprint

Problem: I am searching for a library in Java or JavaScript (or maybe Scala) which is able to generate an HTML representation of Swagger, RAML or API Blueprint input. Background: The idea is to use it as a part of a (Play Framework) web app serving…
nize
  • 1,012
  • 1
  • 11
  • 27
0
votes
2 answers

API Integration using MULE- AnyPoint Studio and RAML (RESTful API Modeling Language)

i am new to mule-AnyPoint Studio. Is it essential to use RAML for api integration using mule- AnyPoint Studio in java.
Tarun Chaudhary
  • 1,046
  • 2
  • 12
  • 20
1 2 3
…
24
25