api/v1/swagger/paths/erm_usage_items.yaml

   1 ---
   2 /erm/usage_items:
   3   get:
   4     x-mojo-to: ERM::EUsage::UsageItems#list
   5     operationId: listErmUsageItems
   6     tags:
   7       - erm_usage_items
   8     summary: List usage_items
   9     produces:
  10       - application/json
  11     parameters:
  12       - description: Case insensitive search on usage_item item_id
  13         in: query
  14         name: item_id
  15         required: false
  16         type: integer
  17       - description: Case insensitive search on usage_item item
  18         in: query
  19         name: item
  20         required: false
  21         type: string
  22       - description: Case insensitive search on usage_item usage_data_provider_id
  23         in: query
  24         name: usage_data_provider_id
  25         required: false
  26         type: string
  27       - description: Case insensitive search on usage_item platform
  28         in: query
  29         name: platform
  30         required: false
  31         type: string
  32       - description: Case insensitive search on usage_item publisher
  33         in: query
  34         name: publisher
  35         required: false
  36         type: string
  37       - name: x-koha-embed
  38         in: header
  39         required: false
  40         description: Embed list sent as a request header
  41         type: array
  42         items:
  43           type: string
  44           enum:
  45             - erm_usage_muses
  46             - erm_usage_yuses
  47         collectionFormat: csv
  48       - $ref: "../swagger.yaml#/parameters/match"
  49       - $ref: "../swagger.yaml#/parameters/order_by"
  50       - $ref: "../swagger.yaml#/parameters/page"
  51       - $ref: "../swagger.yaml#/parameters/per_page"
  52       - $ref: "../swagger.yaml#/parameters/q_param"
  53       - $ref: "../swagger.yaml#/parameters/q_body"
  54       - $ref: "../swagger.yaml#/parameters/request_id_header"
  55     responses:
  56       200:
  57         description: A list of usage_items
  58         schema:
  59           items:
  60             $ref: "../swagger.yaml#/definitions/erm_usage_item"
  61           type: array
  62       400:
  63         description: Bad request
  64         schema:
  65           $ref: "../swagger.yaml#/definitions/error"
  66       403:
  67         description: Access forbidden
  68         schema:
  69           $ref: "../swagger.yaml#/definitions/error"
  70       500:
  71         description: |-
  72           Internal server error. Possible `error_code` attribute values:
  73           * `internal_server_error`
  74         schema:
  75           $ref: "../swagger.yaml#/definitions/error"
  76       503:
  77         description: Under maintenance
  78         schema:
  79           $ref: "../swagger.yaml#/definitions/error"
  80     x-koha-authorization:
  81       permissions:
  82         erm: 1