List Presence


This request shows messages, location, status and status icon of the presence entry. This information is contained in the phone line.

Resource

GET /presence[?parameters]

Parameters

Name Type Description

name

String

Select information of phone lines that match this string.

with

String

Select information of persons that match this string.

limit

Integer

The maximum number of objects to return. Default: 15.

before

[id]

Paging: return results before the specified ID.

after

[id]

Paging: return results after the specified ID.

Payload

None

Response

Context

Authorization

User

Errors

Example

Request
GET https://xelion.nl/api/v1/master/presence?limit=2
Response
{
  "data": [
    {
      "object": {
        "id": "1556616",
        "status": "online",
        "statusIcon": "statusGreen",
        "message": "a verbal, written or recorded communication sent to a recipient. Synonym: communication",
        "location": "office",
        "addressable": {
          "commonName": "Arnon Ron",
          "oid": "1556377",
          "objectType": "Person"
        }
      }
    },
    {
      "object": {
        "id": "1556880",
        "status": "available",
        "statusIcon": "statusGreen",
        "message": "i'll be back",
        "location": "home",
        "addressable": {
          "commonName": "Wim Bokkers",
          "oid": "1556825",
          "objectType": "Person"
        }
      }
    }
  ],
  "meta": {
    "links": [
      {
        "rel": "refresh",
        "href": "http://www.xelion.nl/api/v1/master/presence",
        "method": "GET"
      },
      {
        "rel": "next",
        "href": "http://www.xelion.nl/api/v1/master/presence?after=1556880",
        "method": "GET"
      },
      {
        "rel": "previous",
        "href": "http://www.xelion.nl/api/v1/master/presence?before=1556616",
        "method": "GET"
      }
    ],
    "paging": {
      "previousId": "1556616",
      "nextId": "1556880"
    }
  }
}