RAML to HTML using Include


#1

hello,

I am trying to convert RAML to HTML using Java convertor, but convertor throw error message saying !inclide files could not be located. My raml and Json files are located in same directory. Please find my file. Can any one point how to include external files?

#%RAML 0.8
baseUri: http://mocksvc.mulesoft.com/mocks/c7dbe025-2b9c-41b5-93e7-bb8fb86f1ce2
title: Tax service
version: 1.0

schemas:

  • GetQuote200: !include tax-avalara/schemas/v1/GetQuote200.json
  • GetQuote401: !include tax-avalara/schemas/v1/GetQuote401.json
  • GetQuote403: !include tax-avalara/schemas/v1/GetQuote403.json
  • GetQuote415: !include tax-avalara/schemas/v1/GetQuote415.json
  • GetQuote500: !include tax-avalara/schemas/v1/GetQuote500.json
  • PostQuote: !include tax-avalara/schemas/v1/PostQuote.json

/quote:
displayName: Get a tax quotation
post:
description: Post a tax quotation
body:
application/json:
schema : PostQuote
responses:
200:
body:
application/json:
schema : GetQuote200
401:
body:
application/json:
schema : GetQuote401
403:
body:
application/json:
schema : GetQuote403
415:
body:
application/json:
schema : GetQuote415
500:
body:
application/json:
schema : GetQuote500


#2

As in my other comment - please try raml2html or php-raml2html if that works for you. Out of interest, what Java converter do you use?


#3

JAVA Convertor: http://grepcode.com/snapshot/repo1.maven.org/maven2/de.androbit/raml-converter/0.9/

how to add same response code multiple times?

for ex:
/quote:

post:
description: Post a tax quotation.
body:
application/json:
schema: postquote
responses:
200:
body:
application/json:
schema : getquote200
204:
body:
application/json:
schema : getquote204
204:
body:
application/json:
schema : GetQuote204-1
204:
body:
application/json:
schema : GetQuote204