Improve "filter" arg description

Add an example showing how to serialize object values as JSON.
This commit is contained in:
Raymond Camden 2017-02-20 10:30:01 -06:00 committed by Miroslav Bajtoš
parent 42780567a8
commit a4154caf59
No known key found for this signature in database
GPG Key ID: 797723F23CE0A94A
1 changed files with 7 additions and 3 deletions

View File

@ -749,7 +749,9 @@ module.exports = function(registry) {
{ arg: 'id', type: 'any', description: 'Model id', required: true,
http: {source: 'path'}},
{arg: 'filter', type: 'object',
description: 'Filter defining fields and include'},
description:
'Filter defining fields and include - must be a JSON-encoded string (' +
'{"something":"value"})'},
{arg: 'options', type: 'object', http: 'optionsFromRequest'},
]),
returns: {arg: 'data', type: typeName, root: true},
@ -782,7 +784,8 @@ module.exports = function(registry) {
accessType: 'READ',
accepts: this._removeOptionsArgIfDisabled([
{arg: 'filter', type: 'object', description:
'Filter defining fields, where, include, order, offset, and limit'},
'Filter defining fields, where, include, order, offset, and limit - must be a ' +
'JSON-encoded string ({"something":"value"})'},
{arg: 'options', type: 'object', http: 'optionsFromRequest'},
]),
returns: {arg: 'data', type: [typeName], root: true},
@ -794,7 +797,8 @@ module.exports = function(registry) {
accessType: 'READ',
accepts: this._removeOptionsArgIfDisabled([
{arg: 'filter', type: 'object', description:
'Filter defining fields, where, include, order, offset, and limit'},
'Filter defining fields, where, include, order, offset, and limit - must be a ' +
'JSON-encoded string ({"something":"value"})'},
{arg: 'options', type: 'object', http: 'optionsFromRequest'},
]),
returns: {arg: 'data', type: typeName, root: true},