DaaS API
Docs & Playground
Reference (Get)/Get Zone

Get Zonetoken required

Geofences: polygon points (x = longitude, y = latitude).

POST/daas/apiv1— method = "Get", params.typeName = "Zone"

Parameters

typeName is "Zone".

NameTypeRequiredDescription
search.idstringoptionalOnly the entity with this id.
resultsLimitnumberoptionalRecords per call. Default and maximum 5,000.e.g. 100
sort.sortBystringoptionalPage through results: id.e.g. id
sort.offsetstringoptionalid of the last record of the previous page.

Request

curl
curl -X POST 'https://private.develop-1.questar.io/v2/private-questar-units/daas/apiv1' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  --data '{"method":"Get","params":{"typeName":"Zone","resultsLimit":100,"sort":{"sortBy":"id"}}}'
Body
{
  "method": "Get",
  "params": {
    "typeName": "Zone",
    "resultsLimit": 100,
    "sort": {
      "sortBy": "id"
    }
  }
}

Response

200 OK
{
  "jsonrpc": "2.0",
  "result": [
    {
      "id": "2-7140754",
      "name": "Sample Geofence",
      "comment": "",
      "points": [
        {
          "x": 3.331188,
          "y": 6.620022
        },
        {
          "x": 3.335782,
          "y": 6.623537
        },
        {
          "x": 3.354967,
          "y": 6.626412
        }
      ],
      "activeTo": "2050-01-01T00:00:00.000Z",
      "version": "000001a1544aaf5a"
    }
  ]
}

Errors also come back as HTTP 200, with an error instead of a result. error.data.type says what went wrong: ArgumentException (a bad parameter), MissingMethodException (unknown method) or InvalidOperationException. With no or an invalid token the gateway answers HTTP 401 / 403.

200 OK
{
  "jsonrpc": "2.0",
  "error": {
    "code": -32000,
    "message": "Get does not support typeName 'Media'",
    "name": "JSONRPCError",
    "data": {
      "type": "ArgumentException"
    },
    "errors": [
      {
        "message": "Get does not support typeName 'Media'",
        "name": "ArgumentException"
      }
    ]
  }
}