README.mustache 1.9 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758
  1. # Documentation for {{appName}}
  2. {{#generateApiDocs}}
  3. <a name="documentation-for-api-endpoints"></a>
  4. ## Documentation for API Endpoints
  5. All URIs are relative to *{{{basePath}}}*
  6. API | Operation | HTTP request | Description
  7. ------------ | ------------- | ------------- | -------------
  8. {{#apiInfo}}{{#apis}}{{#operations}}{{#operation}}*{{classname}}* | [**{{#lambda.titlecase}}{{operationId}}{{/lambda.titlecase}}**](./Apis/{{apiDocPath}}{{classname}}.md#{{#lambda.lowercase}}{{operationId}}{{/lambda.lowercase}}) | **{{httpMethod}}** {{path}} | {{#summary}}{{{summary}}}{{/summary}}
  9. {{/operation}}{{/operations}}{{/apis}}{{/apiInfo}}
  10. {{/generateApiDocs}}
  11. {{#generateModelDocs}}
  12. <a name="documentation-for-models"></a>
  13. ## Documentation for Models
  14. {{#modelPackage}}
  15. {{#models}}{{#model}} - [{{{classname}}}](./Models/{{modelDocPath}}{{{classname}}}.md)
  16. {{/model}}{{/models}}
  17. {{/modelPackage}}
  18. {{^modelPackage}}
  19. No model defined in this package
  20. {{/modelPackage}}
  21. {{/generateModelDocs}}
  22. <a name="documentation-for-authorization"></a>
  23. ## Documentation for Authorization
  24. {{^authMethods}}
  25. All endpoints do not require authorization.
  26. {{/authMethods}}
  27. {{#authMethods}}
  28. {{#last}}
  29. Authentication schemes defined for the API:
  30. {{/last}}
  31. {{/authMethods}}
  32. {{#authMethods}}
  33. <a name="{{name}}"></a>
  34. ### {{name}}
  35. {{#isApiKey}}- **Type**: API key
  36. - **API key parameter name**: {{keyParamName}}
  37. - **Location**: {{#isKeyInQuery}}URL query string{{/isKeyInQuery}}{{#isKeyInHeader}}HTTP header{{/isKeyInHeader}}
  38. {{/isApiKey}}
  39. {{#isBasic}}- **Type**: HTTP basic authentication
  40. {{/isBasic}}
  41. {{#isOAuth}}- **Type**: OAuth
  42. - **Flow**: {{flow}}
  43. - **Authorization URL**: {{authorizationUrl}}
  44. - **Scopes**: {{^scopes}}N/A{{/scopes}}
  45. {{#scopes}} - {{scope}}: {{description}}
  46. {{/scopes}}
  47. {{/isOAuth}}
  48. Consult the [User Guide](../USER_GUIDE.md#making-authenticated-api-requests) to make authenticated requests.
  49. {{/authMethods}}