...
Resources have general responses/requests which can be used in other modules and contained in this way(spec/__def__/models)
All constraints, enums, requests/responses from spec module you can reuse in other modules, e.g.
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<endpoint xmlns="http://www.knubisoft.com/api/schema/endpoint">
<swagger>
<operationId>login</operationId>
<summary>Logging in</summary>
<description>Logging in with user credentials</description>
<tags>
<tag>Login</tag>
</tags>
</swagger>
<responses>
<_200>Success HTTP response from API with HTTP body</_200>
<_404>Accepted HTTP call request but requested object is NOT FOUND</_404>
</responses>
<post>
<response include="jwtTokensResponse.xml"/>
<request include="loginRequest.xml"/>
</post>
</endpoint>
|
| Info |
|---|
jwtTokensResponse.xml, loginRequest.xml are located in completely different folder |
Also resources have spec.xml this is a main file that describes:
...