Query and Filter

The following examples can be demo'd via the example json:api implementation launched via npm start.

Inclusions

To include author and tags relations of articles:

http://localhost:16006/rest/articles?include=author,tags

To include author, author.photos and tags relations of articles:

http://localhost:16006/rest/articles?include=author.photos,tags

Filtering

To only show articles where the title attribute is exactly mySpecificTitle:

http://localhost:16006/rest/articles?filter[title]=mySpecificTitle

To only show articles where the title attribute is before M alphabetically:

http://localhost:16006/rest/articles?filter[title]=<M

To only show articles where the title attribute is after M alphabetically:

http://localhost:16006/rest/articles?filter[title]=>M

To only show articles where the title attribute is a case-insensitive match against linux-rocks:

http://localhost:16006/rest/articles?filter[title]=~linux-rocks

To only show articles where the title attribute contains for:

http://localhost:16006/rest/articles?filter[title]=:for

To only show included authors``photos where the photoswidth is greater than 500:

http://localhost:16006/rest/articles?include=author.photos&filter[author][photos][width]=>500

Fields

To only bring back articlestitle and content fields:

http://localhost:16006/rest/articles?fields[articles]=title,content

To only bring back articlestitle and content fields, and photosurl fields:

http://localhost:16006/rest/articles?include=photos&fields[articles]=title,content&fields[photos]=url

Sorting

To sort articlesDESC by title:

http://localhost:16006/rest/articles?sort=-title

To sort articlesASC by title:

http://localhost:16006/rest/articles?sort=+title

Pagination

Use page[limit]=50 to limit the number of resources in a search request to 50.

Use page[offset]=10 to chose which resulting resource should start the result set.

To fetch resources 100-149: http://localhost:16006/rest/articles?page[offset]=100&page[limit]=50