swag-payments/spec
Evgeny Levenets f1d58765f6 DC-51: penetrate invoice cart into invoice template (#129)
* DC-51: penetrate invoice cart into invoice template (#107)

* CAPI-180: add currency to multiline invoice template (#128)

* CAPI-180: move product to appropriate location (#130)
2017-10-25 16:38:46 +03:00
..
code_samples ITS-21: Prepare for the release (#31) 2017-02-06 15:09:03 +03:00
definitions DC-51: penetrate invoice cart into invoice template (#129) 2017-10-25 16:38:46 +03:00
paths HG-231: Introduce subscriptions (#125) 2017-10-23 16:26:44 +03:00
wsd general grammar fixes (#36) 2017-02-06 20:15:39 +03:00
README.md ITS-21: Prepare for the release (#31) 2017-02-06 15:09:03 +03:00
swagger.yaml HG-231: Introduce subscriptions (#125) 2017-10-23 16:26:44 +03:00

Global headers

In order to minimize duplications you can use headers global object (similar to definitions, responses). During build process all references to global headers will be inlined and headers will be removed form resulting spec so spec will be valid (global headers is not allowed by Swagger spec):

Example:

...
headers:
  Rate-Limit-Limit:
    description: The number of allowed requests in the current period
    type: integer
...
paths:
  /api-keys:
    get:
      summary: Retrieve a list of api keys
      responses:
        200:
          description: A list of api keys was retrieved successfully
          headers:
            Rate-Limit-Limit:
              $ref: "#/headers/Rate-Limit-Limit"