1 package Koha::REST::V1;
3 # This file is part of Koha.
5 # Koha is free software; you can redistribute it and/or modify it under the
6 # terms of the GNU General Public License as published by the Free Software
7 # Foundation; either version 3 of the License, or (at your option) any later
10 # Koha is distributed in the hope that it will be useful, but WITHOUT ANY
11 # WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
12 # A PARTICULAR PURPOSE. See the GNU General Public License for more details.
14 # You should have received a copy of the GNU General Public License along
15 # with Koha; if not, write to the Free Software Foundation, Inc.,
16 # 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
20 use Mojo::Base 'Mojolicious';
26 Koha::REST::V1 - Main v.1 REST api class
34 Overloaded Mojolicious->startup method. It is called at application startup.
41 # Remove /api/v1/app.pl/ from the path
42 $self->hook( before_dispatch => sub {
43 shift->req->url->base->path('/');
46 # Force charset=utf8 in Content-Type header for JSON responses
47 $self->types->type(json => 'application/json; charset=utf8');
49 my $secret_passphrase = C4::Context->config('api_secret_passphrase');
50 if ($secret_passphrase) {
51 $self->secrets([$secret_passphrase]);
54 $self->plugin(OpenAPI => {
55 url => $self->home->rel_file("api/v1/swagger/swagger.json"),
56 route => $self->routes->under('/api/v1')->to('Auth#under'),
57 allow_invalid_ref => 1, # required by our spec because $ref directly under
58 # Paths-, Parameters-, Definitions- & Info-object
59 # is not allowed by the OpenAPI specification.
61 $self->plugin( 'Koha::REST::Plugin::Pagination' );
62 $self->plugin( 'Koha::REST::Plugin::Query' );
63 $self->plugin( 'Koha::REST::Plugin::Objects' );