]> BookStack Code Mirror - bookstack/blob - app/Http/Controllers/Api/ApiController.php
Merge branch 'api-endpoint-users' into users_api
[bookstack] / app / Http / Controllers / Api / ApiController.php
1 <?php
2
3 namespace BookStack\Http\Controllers\Api;
4
5 use BookStack\Api\ListingResponseBuilder;
6 use BookStack\Http\Controllers\Controller;
7 use Illuminate\Database\Eloquent\Builder;
8 use Illuminate\Http\JsonResponse;
9
10 abstract class ApiController extends Controller
11 {
12     protected $rules = [];
13     protected $printHidden = [];
14
15     /**
16      * Provide a paginated listing JSON response in a standard format
17      * taking into account any pagination parameters passed by the user.
18      */
19     protected function apiListingResponse(Builder $query, array $fields, array $protectedFieldsToPrint = []): JsonResponse
20     {
21         $listing = new ListingResponseBuilder($query, request(), $fields, $protectedFieldsToPrint);
22
23         return $listing->toResponse();
24     }
25
26     /**
27      * Get the validation rules for this controller.
28      * Defaults to a $rules property but can be a rules() method.
29      */
30     public function getValdationRules(): array
31     {
32         if (method_exists($this, 'rules')) {
33             return $this->rules();
34         }
35
36         return $this->rules;
37     }
38 }