v2.htmlDocs.index.mustache Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of swagger-codegen-generators Show documentation
The newest version!


  
    {{{appName}}}
    
  
  
  {{{appName}}}
    {{{appDescription}}}
    {{#infoUrl}}More information: {{{infoUrl}}}{{/infoUrl}}
    {{#infoEmail}}Contact Info: {{{infoEmail}}}{{/infoEmail}}
    {{#version}}Version: {{{version}}}{{/version}}
    {{#basePathWithoutHost}}BasePath:{{basePathWithoutHost}}{{/basePathWithoutHost}}
    {{{licenseInfo}}}
    {{{licenseUrl}}}
  Access
  {{#hasAuthMethods}}
    
    {{#authMethods}}
      {{#is this 'basic'}}HTTP Basic Authentication{{/is}}{{#is this 'oauth'}}OAuth AuthorizationUrl:{{authorizationUrl}}TokenUrl:{{tokenUrl}}{{/is}}{{#is this 'api-key'}}APIKey KeyParamName:{{keyParamName}} KeyInQuery:{{isKeyInQuery}} KeyInHeader:{{isKeyInHeader}}{{/is}}
    {{/authMethods}}
    
  {{/hasAuthMethods}}

  Methods
  [ Jump to Models ]

  {{! for the tables of content, I cheat and don't use CSS styles.... }}
  Table of Contents 
  {{access}}
  {{#apiInfo}}
  {{#apis}}
  {{#operations}}
  {{baseName}}
  
  {{#operation}}
  {{httpMethod}} {{path}}
  {{/operation}}
  
  {{/operations}}
  {{/apis}}
  {{/apiInfo}}

  {{#apiInfo}}
  {{#apis}}
  {{#operations}}
  {{baseName}}
  {{#operation}}
  
    
    Up
    {{httpMethod}} {{path}}
    {{summary}} ({{nickname}})
    {{! notes is operation.description. So why rename it and make it super confusing???? }}
    {{notes}}

    {{#hasPathParams}}
    Path parameters
    
      {{#pathParams}}{{>pathParam}}{{/pathParams}}
    
  
    {{/hasPathParams}}

    {{#has this 'consumes'}}
    Consumes
    This API call consumes the following media types via the Content-Type request header:
    
    {{#consumes}}
      {{{mediaType}}}
    {{/consumes}}
    
    {{/has}}

    {{#hasBodyParam}}
    Request body
    
      {{#bodyParams}}{{>bodyParam}}{{/bodyParams}}
    
  
    {{/hasBodyParam}}

    {{#hasHeaderParams}}
    Request headers
    
      {{#headerParam}}{{>headerParam}}{{/headerParam}}
    
  
    {{/hasHeaderParams}}

    {{#hasQueryParams}}
    Query parameters
    
      {{#queryParams}}{{>queryParam}}{{/queryParams}}
    
  
    {{/hasQueryParams}}

    {{#hasFormParams}}
    Form parameters
    
      {{#formParams}}{{>formParam}}{{/formParams}}
    
  
    {{/hasFormParams}}

    {{#returnType}}
    Return type
    
      {{#hasReference}}{{^returnSimpleType}}{{returnContainer}}[{{/returnSimpleType}}{{returnBaseType}}{{^returnSimpleType}}]{{/returnSimpleType}}{{/hasReference}}
      {{^hasReference}}{{returnType}}{{/hasReference}}
    
    {{/returnType}}

    

    {{#hasExamples}}
    {{#examples}}
    Example data
    Content-Type: {{{contentType}}}
    {{{example}}}
    {{/examples}}
    {{/hasExamples}}

    {{#has this 'produces'}}
    Produces
    This API call produces the following media types according to the Accept request header;
    the media type will be conveyed by the Content-Type response header.
    
    {{#produces}}
      {{{mediaType}}}
    {{/produces}}
    
    {{/has}}

    Responses
    {{#responses}}
    {{code}}
    {{message}}
        {{#simpleType}}{{dataType}}{{/simpleType}}
    {{#examples}}
    Example data
    Content-Type: {{{contentType}}}
    {{example}}
    {{/examples}}
    {{/responses}}
  
 
  
  {{/operation}}
  {{/operations}}
  {{/apis}}
  {{/apiInfo}}

  Models
  [ Jump to Methods ]

  Table of Contents
  
  {{#models}}
  {{#model}}
    {{name}}{{#title}} - {{title}}{{/title}}
  {{/model}}
  {{/models}}
  

  {{#models}}
  {{#model}}
  
    {{name}}{{#title}} - {{title}}{{/title}} Up
    {{#unescapedDescription}}{{unescapedDescription}}{{/unescapedDescription}}
    
      {{#vars}}{{name}} {{^required}}(optional){{/required}}
{{#isNot this 'primitive-type'}}{{datatype}}{{/isNot}} {{unescapedDescription}} {{#dataFormat}}format: {{{dataFormat}}}{{/dataFormat}}
      {{#is this 'enum'}}
        Enum:
        {{#_enum}}{{this}}{{/_enum}}
      {{/is}}
      {{/vars}}
    
  
  
  {{/model}}
  {{/models}}