json-api-server/docs/list.md

844 B

Listing Resources

For each resource type, a GET /{type} endpoint is exposed to list resources.

If you want to restrict the ability to list a resource type, use the listable and notListable methods. You can optionally pass a closure that returns a boolean value.

$type->notListable();

$type->listable(function (Context $context) {
    return $context->getRequest()->getAttribute('user')->isAdmin();
});

Events

listing

Run before scopes are applied to the $query and results are retrieved.

$type->listing(function ($query, Context $context) {
    // do something
});

listed

Run after models and relationships have been retrieved, but before they are serialized into a JSON:API document.

$type->listed(function ($models, Context $context) {
    // do something
});