Koha/api/v1/swagger/paths/erm_eholdings_titles_resources.yaml
Martin Renvoize 79f7f44aa1
Bug 33145: Fix ERM swagger specs
This patch adds the missing 'Provider name' parameter definition to the
various ERM paths that were missing it.

Test plan
1) Run:
   docker run --rm -v $PWD/api/v1/swagger:/swagger \
          jeanberu/swagger-cli \
          swagger-cli validate swagger/swagger.yaml
=> FAIL: The spec is not valid!
2) Apply this patch
3) Repeat 1
=> SUCCESS: Tests pass!

Signed-off-by: Marcel de Rooy <m.de.rooy@rijksmuseum.nl>
Signed-off-by: Tomas Cohen Arazi <tomascohen@theke.io>
Edit: tcohen edited the test plan because of the failure to install
swagger-cli cleanly
Signed-off-by: Tomas Cohen Arazi <tomascohen@theke.io>
2023-03-06 09:51:43 -03:00

82 lines
2.4 KiB
YAML

---
/erm/eholdings/{provider}/titles/{title_id}/resources:
get:
x-mojo-to: ERM::EHoldings::Resources#list
operationId: listErmEHoldingsTitlesResources
tags:
- eholdings
summary: List eholdings resources
produces:
- application/json
parameters:
- description: Provider name
in: path
name: provider
required: true
type: string
- description: Case insensitive search on resource_id
in: query
name: resource_id
required: false
type: string
- description: Case insensitive search on started_on
in: query
name: started_on
required: false
type: string
- description: Case insensitive search on ended_on
in: query
name: ended_on
required: false
type: string
- description: Case insensitive search on proxy
in: query
name: proxy
required: false
type: string
- $ref: "../swagger.yaml#/parameters/eholdings_title_id_pp"
- $ref: "../swagger.yaml#/parameters/match"
- $ref: "../swagger.yaml#/parameters/order_by"
- $ref: "../swagger.yaml#/parameters/page"
- $ref: "../swagger.yaml#/parameters/per_page"
- $ref: "../swagger.yaml#/parameters/q_param"
- $ref: "../swagger.yaml#/parameters/q_body"
- $ref: "../swagger.yaml#/parameters/q_header"
- name: x-koha-embed
in: header
required: false
description: Embed list sent as a request header
type: array
items:
type: string
enum:
- title.publication_title
collectionFormat: csv
responses:
200:
description: A list of eHoldings resources
schema:
items:
$ref: "../swagger.yaml#/definitions/erm_eholdings_resource"
type: array
400:
description: Bad request
schema:
$ref: "../swagger.yaml#/definitions/error"
403:
description: Access forbidden
schema:
$ref: "../swagger.yaml#/definitions/error"
500:
description: |-
Internal server error. Possible `error_code` attribute values:
* `internal_server_error`
schema:
$ref: "../swagger.yaml#/definitions/error"
503:
description: Under maintenance
schema:
$ref: "../swagger.yaml#/definitions/error"
x-koha-authorization:
permissions:
erm: 1