Koha/api/v1/swagger/paths/items.yaml
Martin Renvoize c66032ba2c
Bug 28854: Improve lost details display for bundle items
This patch adds the return claim details to the bundle item status
display on the catalogue details page.

Signed-off-by: Katrin Fischer <katrin.fischer@bsz-bw.de>

Signed-off-by: Kyle M Hall <kyle@bywatersolutions.com>
Signed-off-by: Tomas Cohen Arazi <tomascohen@theke.io>
2022-07-13 10:35:36 -03:00

318 lines
9.1 KiB
YAML

---
/items:
get:
x-mojo-to: Items#list
operationId: listItems
tags:
- items
summary: List items
parameters:
- name: external_id
in: query
description: Search on the item's barcode
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"
- $ref: "../swagger.yaml#/parameters/request_id_header"
consumes:
- application/json
produces:
- application/json
responses:
"200":
description: A list of item
schema:
type: array
items:
$ref: "../swagger.yaml#/definitions/item"
"401":
description: Authentication required
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:
catalogue: "1"
"/items/{item_id}":
get:
x-mojo-to: Items#get
operationId: getItem
tags:
- items
summary: Get item
parameters:
- $ref: "../swagger.yaml#/parameters/item_id_pp"
consumes:
- application/json
produces:
- application/json
responses:
"200":
description: An item
schema:
$ref: "../swagger.yaml#/definitions/item"
"400":
description: Missing or wrong parameters
schema:
$ref: "../swagger.yaml#/definitions/error"
"404":
description: Item 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:
catalogue: "1"
"/items/{item_id}/bundled_items":
post:
x-mojo-to: Items#add_to_bundle
operationId: addToBundle
tags:
- items
summary: Add item to bundle
parameters:
- $ref: "../swagger.yaml#/parameters/item_id_pp"
- name: body
in: body
description: A JSON object containing information about the new bundle link
required: true
schema:
$ref: "../swagger.yaml#/definitions/bundle_link"
consumes:
- application/json
produces:
- application/json
responses:
"201":
description: A successfully created bundle link
schema:
items:
$ref: "../swagger.yaml#/definitions/item"
"400":
description: Bad parameter
schema:
$ref: "../swagger.yaml#/definitions/error"
"401":
description: Authentication required
schema:
$ref: "../swagger.yaml#/definitions/error"
"403":
description: Access forbidden
schema:
$ref: "../swagger.yaml#/definitions/error"
"404":
description: Resource not found
schema:
$ref: "../swagger.yaml#/definitions/error"
"409":
description: Conflict in creating resource
schema:
$ref: "../swagger.yaml#/definitions/error"
"500":
description: Internal server error
schema:
$ref: "../swagger.yaml#/definitions/error"
"503":
description: Under maintenance
schema:
$ref: "../swagger.yaml#/definitions/error"
x-koha-authorization:
permissions:
catalogue: 1
get:
x-mojo-to: Items#bundled_items
operationId: bundledItems
tags:
- items
summary: List bundled items
parameters:
- $ref: "../swagger.yaml#/parameters/item_id_pp"
- name: external_id
in: query
description: Search on the item's barcode
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"
consumes:
- application/json
produces:
- application/json
responses:
"200":
description: A list of item
schema:
type: array
items:
$ref: "../swagger.yaml#/definitions/item"
"401":
description: Authentication required
schema:
$ref: "../swagger.yaml#/definitions/error"
"403":
description: Access forbidden
schema:
$ref: "../swagger.yaml#/definitions/error"
"500":
description: Internal server error
schema:
$ref: "../swagger.yaml#/definitions/error"
"503":
description: Under maintenance
schema:
$ref: "../swagger.yaml#/definitions/error"
x-koha-authorization:
permissions:
catalogue: "1"
x-koha-embed:
- biblio
- checkout
- return_claims
- return_claim
- return_claim.patron
"/items/{item_id}/bundled_items/{bundled_item_id}":
delete:
x-mojo-to: Items#remove_from_bundle
operationId: removeFromBundle
tags:
- items
summary: Remove item from bundle
parameters:
- $ref: "../swagger.yaml#/parameters/item_id_pp"
- name: bundled_item_id
in: path
description: Internal identifier for the bundled item
required: true
type: string
consumes:
- application/json
produces:
- application/json
responses:
"204":
description: Bundle link deleted
"400":
description: Bad parameter
schema:
$ref: "../swagger.yaml#/definitions/error"
"401":
description: Authentication required
schema:
$ref: "../swagger.yaml#/definitions/error"
"403":
description: Access forbidden
schema:
$ref: "../swagger.yaml#/definitions/error"
"404":
description: Resource not found
schema:
$ref: "../swagger.yaml#/definitions/error"
"500":
description: Internal server error
schema:
$ref: "../swagger.yaml#/definitions/error"
"503":
description: Under maintenance
schema:
$ref: "../swagger.yaml#/definitions/error"
x-koha-authorization:
permissions:
catalogue: 1
"/items/{item_id}/pickup_locations":
get:
x-mojo-to: Items#pickup_locations
operationId: getItemPickupLocations
summary: Get valid pickup locations for an item
tags:
- items
parameters:
- $ref: "../swagger.yaml#/parameters/item_id_pp"
- name: patron_id
in: query
description: Internal patron identifier
required: true
type: integer
- $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"
- $ref: "../swagger.yaml#/parameters/request_id_header"
consumes:
- application/json
produces:
- application/json
responses:
"200":
description: Item pickup locations
schema:
type: array
items:
$ref: "../swagger.yaml#/definitions/library"
"400":
description: Missing or wrong parameters
schema:
$ref: "../swagger.yaml#/definitions/error"
"401":
description: Authentication required
schema:
$ref: "../swagger.yaml#/definitions/error"
"403":
description: Access forbidden
schema:
$ref: "../swagger.yaml#/definitions/error"
"404":
description: Biblio 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:
reserveforothers: place_holds