Koha/api/v1/swagger/paths/erm_default_usage_reports.yaml
Matt Blenkinsop a811dc236b
Bug 35219: Fix ERM usage endpoints to show in docs
This patch fixes the tags and also adds the tags to the swagger.yaml
file to allow the endpoints to be documented correctly.

One endpoint has also been deleted as it is no longer required.

Test plan:
Check the attached files to see that all tags are now prefixed with
'erm_' and that the swagger file now includes an entry for all of these
files

Signed-off-by: Owen Leonard <oleonard@myacpl.org>
Signed-off-by: Katrin Fischer <katrin.fischer.83@web.de>
Signed-off-by: Tomas Cohen Arazi <tomascohen@theke.io>
2023-11-06 08:42:40 -03:00

167 lines
No EOL
5.2 KiB
YAML

---
/erm/default_usage_reports:
get:
x-mojo-to: ERM::EUsage::DefaultUsageReports#list
operationId: listErmDefaultUsageReports
tags:
- erm_default_usage_reports
summary: List default_usage_reports
produces:
- application/json
parameters:
- description: Case insensitive search on erm_default_usage_report_id
in: query
name: erm_default_usage_report_id
required: false
type: integer
- description: Case insensitive search on default_usage_report report_name
in: query
name: report_name
required: false
type: integer
- description: Case insensitive search on default_usage_report report_url_params
in: query
name: report_url_params
required: false
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"
responses:
200:
description: A list of default_usage_reports
schema:
items:
$ref: "../swagger.yaml#/definitions/erm_default_usage_report"
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
post:
x-mojo-to: ERM::EUsage::DefaultUsageReports#add
operationId: addErmDefaultUsageReports
tags:
- erm_default_usage_reports
summary: Add default_usage_report
consumes:
- application/json
produces:
- application/json
parameters:
- description: A JSON object containing information about the new default_usage_report
in: body
name: body
required: true
schema:
$ref: "../swagger.yaml#/definitions/erm_default_usage_report"
responses:
201:
description: A successfully created default_usage_report
schema:
items:
$ref: "../swagger.yaml#/definitions/erm_default_usage_report"
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: Ressource not found
schema:
$ref: "../swagger.yaml#/definitions/error"
409:
description: Conflict in creating resource
schema:
$ref: "../swagger.yaml#/definitions/error"
413:
description: Payload too large
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/default_usage_reports/{erm_default_usage_report_id}":
delete:
x-mojo-to: ERM::EUsage::DefaultUsageReports#delete
operationId: deleteERMDefaultUsageReports
tags:
- erm_default_usage_reports
summary: Delete default_usage_report
produces:
- application/json
parameters:
- $ref: "../swagger.yaml#/parameters/erm_default_usage_report_id_pp"
responses:
204:
description: default_usage_report deleted
400:
description: default_usage_report deletion failed
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: ressource not found
schema:
$ref: "../swagger.yaml#/definitions/error"
409:
description: conflict in deleting resource
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