# Liệt kê lượt chạy

> operationId: `listRuns`


## Yêu cầu

Endpoint này liệt kê các bản ghi thực thi. Tham số templateId là tùy chọn. Tham số status chỉ nhận một trạng thái duy nhất, không nhận chuỗi phân tách bằng dấu phẩy. Các trạng thái đang hoạt động là queued/preparing/running/cancel_requested, mọi bản ghi khác đều ở trạng thái kết thúc. Trạng thái failed bao gồm các lượt chạy không thể xác nhận đã dừng và các lượt chạy được khôi phục sau khi ứng dụng máy tính thoát. Cả các bản ghi này lẫn bản ghi stopped đều không có nghĩa là các tác dụng phụ trên trang web đã dừng, vì vậy vẫn cần kiểm tra isolation.

- **Điều kiện tiên quyết**: Thông tin xác thực có quyền đọc các lượt chạy trong phạm vi đích.
- **Xác thực truy cập**: Giống như ở các phần khác của Local API; xem [Xác thực](/vi/api-reference/getting-started/authentication). Tài nguyên thuộc phạm vi dữ liệu của tài khoản/nhóm hiện tại.
- **Tác dụng phụ**: Không có. Lệnh gọi này không ghi dữ liệu nghiệp vụ.
- **Tín hiệu hoàn tất**: 200 trả về bản tóm tắt các lượt chạy và thông tin phân trang.
- **Thử lại**: Có thể thử lại các lệnh gọi chỉ đọc. Khi nhận 429 hoặc 503, hãy tạm dừng theo Retry-After.


### Endpoint

```http
GET /api/rpa/browser/v1/runs
```

Local API: `http://127.0.0.1:<port>/api/rpa/browser/v1/runs`. Dùng cổng được cấu hình trong ứng dụng.

### Header

| Tham số | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `Authorization` | string | Khi bật xác thực Local API | Xem [Xác thực](/vi/api-reference/getting-started/authentication). |


### Tham số đường dẫn

Không có.

### Tham số truy vấn

| Tham số | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `page` | integer | Không | Số trang, bắt đầu từ 1. Tối thiểu 1; mặc định 1 |
| `pageSize` | integer | Không | Số mục mỗi trang. Mặc định 20, tối đa 100. Tối thiểu 1; tối đa 100; mặc định 20 |
| `templateId` | string | Không | ID mẫu đích (ID đám mây của mẫu trong Mẫu tùy chỉnh của ứng dụng, là một chuỗi số). Độ dài tối thiểu 1; độ dài tối đa 128 |
| `status` | [RunStatus](/vi/browser-rpa/api/data-types#runstatus) | Không | Trạng thái hiện tại, được đối chiếu với enum của mô hình. |


### Phần thân yêu cầu

Không có phần thân yêu cầu.

### Ví dụ yêu cầu

Đây là ví dụ minh họa trong tài liệu; ví dụ này chưa được gửi tới một ứng dụng đang chạy thực tế. Đặt `RPA_BASE_URL` theo mô tả trong [Quy ước API](/vi/browser-rpa/api/common). Các biến tài nguyên, bản sửa đổi danh mục và ETag lấy từ phản hồi thực tế.

```bash
curl -i -X GET "${RPA_BASE_URL}/runs?page=1&pageSize=20"
```

## Phản hồi

### 200

200 trả về bản tóm tắt các lượt chạy và thông tin phân trang.

Phần thân: `application/json`. Trường `data` ở cấp cao nhất dùng mô hình bên dưới. Về `meta`, xem [Metadata](/vi/browser-rpa/api/data-types#metadata).

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `items` | array<[RunSummary](/vi/browser-rpa/api/data-types#runsummary)> | Có | Mảng các mục trên trang hiện tại hoặc của tài nguyên hiện tại. |
| `total` | integer | Có | Tổng số kết quả khớp. Tối thiểu 0. |
| `page` | integer | Có | Số trang, bắt đầu từ 1. Tối thiểu 1. |
| `pageSize` | integer | Có | Số mục mỗi trang. Mặc định 20, tối đa 100. Tối thiểu 1; tối đa 100. |


### Ví dụ phản hồi

Mọi ID, dấu thời gian, giá trị băm và kết quả lượt chạy đều là dữ liệu ví dụ. Các giá trị này không cho thấy ví dụ đã được thực thi.

```json
{
  "data": {
    "items": [
      {
        "id": "run_example",
        "status": "queued",
        "template": {
          "id": "template_example",
          "title": "Read the page URL",
          "version": 1,
          "revisionId": "revision_example_1"
        },
        "environment": {
          "id": "environment_example",
          "name": "Example browser profile"
        },
        "createdAt": 1793318400000,
        "startedAt": null,
        "endedAt": null,
        "startAfter": null,
        "hasNodeErrors": false,
        "isolation": null
      }
    ],
    "total": 1,
    "page": 1,
    "pageSize": 20
  },
  "meta": {
    "requestId": "7d498f20-7bab-4e59-9b05-88daf51230e9",
    "catalogRevision": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  }
}
```

### Phản hồi lỗi

Về các lỗi 400/401/403/404/429/5xx thường gặp và các trường mô tả thất bại, xem [Lỗi và khôi phục](/vi/browser-rpa/api/common#l%E1%BB%97i-v%C3%A0-kh%C3%B4i-ph%E1%BB%A5c). Ví dụ phản hồi lỗi (403):

```json
{
  "error": {
    "code": "RPA_PERMISSION_DENIED",
    "message": "The request Host or Origin is not allowed, or the current identity can't access the target environment",
    "retryable": false,
    "issues": [],
    "details": null
  },
  "meta": {
    "requestId": "7d498f20-7bab-4e59-9b05-88daf51230e9",
    "catalogRevision": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  }
}
```

## Liên quan

[Tham chiếu Local API](/vi/browser-rpa/local-api) · [Quy ước API](/vi/browser-rpa/api/common) · [Mô hình dữ liệu](/vi/browser-rpa/api/data-types) · [Cấu trúc quy trình](/vi/browser-rpa/api/workflow) · [Bắt đầu nhanh](/vi/browser-rpa/quickstart)