Specifying Query Parameters in REST APIs

From AgileApps Support Wiki
Revision as of 19:40, 24 June 2010 by imported>Aeric (→‎Specifying Request Arguments)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Specifying Request Arguments

In a REST request, you pass arguments in the form of query parameters. Those parameters are specified in the form parameterName=value.

A parameter list is appended to a URI after a "?". Multiple parameters are separated by "&", as shown here:

  http://{domain}/{address}?parameterName1=value1&parameterName2=value2

For example:

  http://myLongJump.com/networking/rest/user?fieldList=*&sortBy=first_name

For boolean arguments, the value passed can be "1" or "true", "0" or "false".

In some cases, it may be necessary to encode special characters in order to include them in an argument value.

Specifying Response Format

You specify the response format as either XML (the default) or JSON, using the alt parameter:

  • ?alt=xml
  • ?alt=json
Example
  http://{domain}/{address}?alt=json