List paired phones

GET

/devices

const url = 'http://127.0.0.1:7700/api/devices';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url http://127.0.0.1:7700/api/devices \
  --header 'Authorization: Bearer <token>'

Owner only. Phones that are paired and not revoked. Tokens are never listed. GET /pair/devices is the same route under its older name.

Authorizations

deviceToken
accessToken

Responses

200

The devices.

application/json

Array<object>

object

required

string

name

required

string

pairedAt

required

string format: date-time

owner

Paired as the owner’s device.

boolean

Example

[
  {
    "id": "d4e5f6a7b8c"
  }
]

403

The owner’s route, called by someone who is not the box’s own screen or a device paired as the owner.

application/json

object

error

required

What went wrong

string

Example

{
  "error": "only the box's own screen or the owner's paired device can do this"
}

GurtOS is open source under the Apache License 2.0.Source code on GitHub.