Query users

Your service can query users as follows:

Use this method to query current amount of online and registered online users for application.

URL

/nnapi/1.0/users

Note:

This is a cURL command. For more information, see Testing Service using cURL.

Method

GET

Response

200 OK

XML response body includes the information about limitations:

  • Amount of subscribers online.

  • Total amount of subscribers.

<?xml version="1.0" encoding="UTF-8"?>
<?xml version="1.0" encoding="UTF-8"?>
  <users>
  <online desc="Amount of subscribers online">{ONLINE_SUBSCRIBERS}</online>
  <subscribers desc="Total amount of subscribers">{SUBSCRIBERS}</subscribers>
</users>

Error cases

400 Bad Request

Unknown version. Only version 1.0 is currently supported. Any other version (or no version) returns 400 Bad Request.

401 Unauthorized

  • Authorisation failed. Incorrect service credentials.

  • TCP/TLS connection for the HTTP requests may not be persistent. Make sure that your service uses a persistent TCP/TLS connection for the HTTP requests.

  • Forbidden service. Service access to Nokia Notifications API is forbidden.

405 Method Not Allowed

Wrong method used. Only GET method is allowed.

Example

Request GET URL

https://alpha.one.ovi.com/nnapi/1.0/users

Response DATA

HTTP/1.1 200 OK
Content-Length:170
Content-Type:application/vnd.nokia.ovi.ona+xml;charset=ISO-8859-1
<?xml version="1.0" encoding="UTF-8"?><users><online desc="Amount of subscribers online">2</online><subscribers desc="Total amount of subscribers">5</subscribers></users>