File: read-device.md

package info (click to toggle)
mozjs140 140.7.0-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 1,216,752 kB
  • sloc: javascript: 2,267,210; cpp: 1,423,664; python: 966,252; ansic: 632,297; xml: 115,965; sh: 15,392; asm: 13,399; makefile: 10,455; yacc: 4,504; perl: 2,223; lex: 1,414; ruby: 1,064; exp: 756; java: 185; sql: 66; sed: 18
file content (41 lines) | stat: -rw-r--r-- 1,040 bytes parent folder | download | duplicates (21)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
# `read device` - [Devices API](../README.md#devices-api)

The `read device` method of the devices API fetches available information regarding a 
specific device.

## HTTP Request

`GET /api/devices/<device_token>`

## Response Payload

```json
{
    "token": "<String>",
    "user_agent": "<String>",
    "last_active": "<String>",
    "name": "<String>"
}
```

- **token** is the unique identifier of the device.
- **user_agent** is the user agent of the request the device was registered with.
- **last_active** defines the point in time the device was last active. Expressed as ISO 8601 date and time format.
- **name** the name the device was assign based on its user agent.

## Example

**Request:**

`GET /api/devices/1d9f5d30-830f-11ea-8dcb-0021ccd76152`

**Response:**

```json
{
    "token": "1d9f5d30-830f-11ea-8dcb-0021ccd76152",
    "user_agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/81.0.4044.113 Safari/537.36",
    "last_active": 1587391153295,
    "name": "Chrome 81.0.4044"
}
```