Device (generic)

POST /device/log/{interactionType}

Logs an interaction against a generic device or none at all. Posting an interaction against no device is allowed only if that interaction type has been flagged as “deviceless” in the configuration or the codebase.

Deviceless interaction types defined in the codebase are:

• connect

• connected

• seen

• entered

• exited

• download

• downloaded

• upload

• feedback

Example request:

POST /device/log/upload

{
  "delegate_id": 1,
  "recordedAt": "201-12-12T06:35:08+1300",
  "upload": "iVBORw0KGgoAA[ ... more base64 encoded stuff ... ]oI5NwAAAABJRU5ErkJggg=="
}

POST /device/seen

This is a special endpoint for UHF readers. They send a list of tags wrapped in a application/x-www-form-urlencoded. Because the software is proprietary we have a dedicated endpoint and some dedicated configuration parameters.

POST /device/log-batch

You can send a batch of requests to this endpoint and they will be processed in order and a ordered collection of responses will be returned.

Example request:

POST /device/log-batch

{
  "interactions": {
    "a": {
      "delegate_id": 1,
      "interactionType": "upload",
      "upload": "$aUniqueName"
    },
    "b": {
      "delegate_id": 1,
      "device_id": 123,
      "interactionType": "check-in"
    }
  },
  "sharedValues": {
    "aUniqueName": "iVBORw0KGgoAA[ ... more base64 encoded stuff ... ]oI5NwAAAABJRU5ErkJggg=="
  }
}