rev. 334
services/apiref
services/apisrv
services/caches
services/caches/formatters
services/caches/search
services/caches/shortcuts
services/logs
services/oauth
services/replicate
services/users

Retrieve information on a single user
:: services/users/user method

Minimum Authentication: Level 1 (see Authentication Levels)
http://www.opencaching.us/okapi/services/users/user
Retrieve information on a single user. This method might be also used to retrieve data of the user in who's name the Access Token have been issued. To do this, include the Access Token in your request, and don't include the user_uuid argument.
fields required

Pipe-separated list of field names which you are interested with. Selected fields will be included in the response.

Currently available fields:

  • uuid - ID of the user,
  • username - username (login) of the user,
  • profile_url - URL of the user's OpenCaching profile page,
  • is_admin - boolean; true is user has admin privileges.

    This value can be accessed only with Level 3 Authentication and only for the user of your Access Token. For all other reads, is_admin will equal null.

  • internal_id - internal ID of the user (DO NOT use this! use the uuid as the user identifier).
user_uuid optional

ID of the user.

This parameter is optional only when you sign your request with an Access Token (Level 3 Authentication). Otherwise, it is required.

format optional Standard common formatting argument.
callback optional Standard common formatting argument.
Plus required consumer_key argument, assigned for your application.

Returned value:

A dictionary of fields you have selected.

If given user does not exist, the method will respond with a HTTP 400 error.