Koha/REST/V1.pm

   1 package Koha::REST::V1;
   2
   3 # This file is part of Koha.
   4 #
   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
   8 # version.
   9 #
  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.
  13 #
  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.
  17
  18 use Modern::Perl;
  19
  20 use Mojo::Base 'Mojolicious';
  21
  22 use Koha::OAuth;
  23
  24 use C4::Context;
  25
  26 =head1 NAME
  27
  28 Koha::REST::V1 - Main v.1 REST api class
  29
  30 =head1 API
  31
  32 =head2 Class Methods
  33
  34 =head3 startup
  35
  36 Overloaded Mojolicious->startup method. It is called at application startup.
  37
  38 =cut
  39
  40 sub startup {
  41     my $self = shift;
  42
  43     # Remove /api/v1/app.pl/ from the path
  44     $self->hook( before_dispatch => sub {
  45         shift->req->url->base->path('/');
  46     });
  47
  48     # Force charset=utf8 in Content-Type header for JSON responses
  49     $self->types->type(json => 'application/json; charset=utf8');
  50
  51     my $secret_passphrase = C4::Context->config('api_secret_passphrase');
  52     if ($secret_passphrase) {
  53         $self->secrets([$secret_passphrase]);
  54     }
  55
  56     $self->plugin('OAuth2::Server' => Koha::OAuth::config);
  57     $self->plugin(OpenAPI => {
  58         url => $self->home->rel_file("api/v1/swagger/swagger.json"),
  59         route => $self->routes->under('/api/v1')->to('Auth#under'),
  60         allow_invalid_ref => 1, # required by our spec because $ref directly under
  61                                 # Paths-, Parameters-, Definitions- & Info-object
  62                                 # is not allowed by the OpenAPI specification.
  63     });
  64     $self->plugin( 'Koha::REST::Plugin::Pagination' );
  65     $self->plugin( 'Koha::REST::Plugin::Query' );
  66     $self->plugin( 'Koha::REST::Plugin::Objects' );
  67 }
  68
  69 1;