File: status.md

package info (click to toggle)
thunderbird 1%3A140.5.0esr-1~deb12u1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm-proposed-updates
  • size: 4,609,180 kB
  • sloc: cpp: 7,672,739; javascript: 5,901,898; ansic: 3,898,899; python: 1,413,347; xml: 653,997; asm: 462,284; java: 180,927; sh: 113,491; makefile: 20,463; perl: 14,288; objc: 13,059; yacc: 4,583; pascal: 3,352; lex: 1,720; ruby: 1,222; exp: 762; sql: 715; awk: 580; php: 436; lisp: 430; sed: 70; csh: 10
file content (48 lines) | stat: -rw-r--r-- 1,568 bytes parent folder | download | duplicates (22)
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
42
43
44
45
46
47
48
# `status` - [Sessions API](../README.md#sessions-api)

The `status` method of the results API returns information about a sessions current status and progress.

## HTTP Request

`GET /api/sessions/<session_token>/status`

## Response Payload

```json
{
  "token": "String",
  "status": "Enum['pending', 'running', 'paused', 'completed', 'aborted']",
  "date_started": "String",
  "date_finished": "String",
  "expiration_date": "String"
}
```

- **token** contains the token of the session corresponding to this status.
- **status** specifies the current status of the session:
  - **pending**: The session was created, can receive updates, however cannot execute tests.
  - **running**: The session currently executes tests.
  - **paused**: The execution of tests in this session is currently paused.
  - **completed**: All tests files include in this session were executed and have a result.
  - **aborted**: The session was finished before all tests were executed.
- **date_started** contains the time the status changed from `PENDING` to `RUNNING` in ISO 8601.
- **date_finished** contains the time the status changed to either `COMPLETED` or `ABORTED` in ISO 8601.
- **expiration_date** contains the time at which the sessions will be deleted in ISO 8601.

## Example

**Request:**

`GET /api/sessions/d9caaae0-c362-11e9-943f-eedb305f22f6/status`

**Response:**

```json
{
  "token": "d9caaae0-c362-11e9-943f-eedb305f22f6",
  "status": "running",
  "date_started": "2019-09-04T14:21:19",
  "date_finished": null,
  "expiration_date": "2019-09-04T14:26:19"
}
```