Koha/api/v1/swagger/paths/erm_eholdings_resources.yaml
Jonathan Druart 98ab918470
Bug 32030: Add/remove resources to/from EBSCO's holdings
Add an "Add to holdings" and "Remove from holdings" buttons on the
resource page.

Signed-off-by: Jonathan Field <jonathan.field@ptfs-europe.com>

Signed-off-by: Martin Renvoize <martin.renvoize@ptfs-europe.com>
Signed-off-by: Kyle M Hall <kyle@bywatersolutions.com>
Signed-off-by: Tomas Cohen Arazi <tomascohen@theke.io>
2022-11-08 09:44:23 -03:00

192 lines
5.5 KiB
YAML

---
/erm/eholdings/{provider}/resources:
get:
x-mojo-to: ERM::EHoldings::Resources#list
operationId: listErmEHoldingsResources
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 package_id
in: query
name: package_id
required: false
type: string
- description: Case insensitive search on title vendor_id
in: query
name: vendor_id
required: false
type: integer
- 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/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"
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
"/erm/eholdings/{provider}/resources/{resource_id}":
get:
x-mojo-to: ERM::EHoldings::Resources#get
operationId: getErmEHoldingsResources
tags:
- eholdings
summary: Get resources
produces:
- application/json
parameters:
- description: Provider name
in: path
name: provider
required: true
type: string
- $ref: "../swagger.yaml#/parameters/eholdings_resource_id_pp"
responses:
200:
description: An eHolding resource
schema:
items:
$ref: "../swagger.yaml#/definitions/erm_eholdings_resource"
401:
description: Authentication required
schema:
$ref: "../swagger.yaml#/definitions/error"
403:
description: Access forbidden
schema:
$ref: "../swagger.yaml#/definitions/error"
404:
description: Ressource not found
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
x-koha-embed:
- resources
- resources.package
patch:
x-mojo-to: ERM::EHoldings::Resources#edit
operationId: editErmEHoldingsResources
tags:
- eholdings
summary: Edit a resource
produces:
- application/json
parameters:
- description: Provider name
in: path
name: provider
required: true
type: string
- description: A JSON object containing the fields to edit
in: body
name: body
required: true
schema:
type: object
properties:
is_selected:
description: Add or remove this resource from remote holdings
type: boolean
additionalProperties: false
- $ref: "../swagger.yaml#/parameters/eholdings_resource_id_pp"
responses:
200:
description: What has been modified
schema:
type: object
properties:
is_selected:
description: Add or remove this resource from remote holdings
type: boolean
additionalProperties: false
401:
description: Authentication required
schema:
$ref: "../swagger.yaml#/definitions/error"
403:
description: Access forbidden
schema:
$ref: "../swagger.yaml#/definitions/error"
404:
description: Ressource not found
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