api/v1/swagger.json

   1 {
   2   "swagger": "2.0",
   3   "info": {
   4     "title": "Koha REST API",
   5     "version": "1",
   6     "license": {
   7       "name": "GPL v3",
   8       "url": "http://www.gnu.org/licenses/gpl.txt"
   9     },
  10     "contact": {
  11       "name": "Koha Team",
  12       "url": "http://koha-community.org/"
  13     }
  14   },
  15   "basePath": "/api/v1",
  16   "paths": {
  17     "/patrons": {
  18       "get": {
  19         "x-mojo-controller": "Koha::REST::V1::Patrons",
  20         "operationId": "listPatrons",
  21         "tags": ["patrons"],
  22         "produces": [
  23           "application/json"
  24         ],
  25         "responses": {
  26           "200": {
  27             "description": "A list of patrons",
  28             "schema": {
  29               "type": "array",
  30               "items": {
  31                 "$ref": "#/definitions/patron"
  32               }
  33             }
  34           },
  35           "403": {
  36             "description": "Access forbidden",
  37             "schema": {
  38               "$ref": "#/definitions/error"
  39             }
  40           }
  41         }
  42       }
  43     },
  44     "/patrons/{borrowernumber}": {
  45       "get": {
  46         "x-mojo-controller": "Koha::REST::V1::Patrons",
  47         "operationId": "getPatron",
  48         "tags": ["patrons"],
  49         "parameters": [
  50           {
  51             "$ref": "#/parameters/borrowernumberPathParam"
  52           }
  53         ],
  54         "produces": [
  55           "application/json"
  56         ],
  57         "responses": {
  58           "200": {
  59             "description": "A patron",
  60             "schema": {
  61               "$ref": "#/definitions/patron"
  62             }
  63           },
  64           "403": {
  65             "description": "Access forbidden",
  66             "schema": {
  67               "$ref": "#/definitions/error"
  68             }
  69           },
  70           "404": {
  71             "description": "Patron not found",
  72             "schema": {
  73               "$ref": "#/definitions/error"
  74             }
  75           }
  76         }
  77       }
  78     }
  79   },
  80   "definitions": {
  81     "$ref": "./definitions/index.json"
  82   },
  83   "parameters": {
  84     "borrowernumberPathParam": {
  85       "name": "borrowernumber",
  86       "in": "path",
  87       "description": "Internal patron identifier",
  88       "required": true,
  89       "type": "integer"
  90     }
  91   }
  92 }