# Liệt kê lượt thực thi nút

> operationId: `listRunNodes`


## Yêu cầu

Liệt kê kết quả thực thi nút. Lệnh gọi này truy vấn các bản ghi thực thi hiện tại; đây không phải là luồng sự kiện. Các tham số nodeId, workflowRevisionId, invocationPath, executionId và status là các bộ lọc tùy chọn, mỗi bộ lọc nhận một giá trị duy nhất và khớp chính xác; các bộ lọc được kết hợp bằng AND. Bộ lọc executionId khớp với items[].id. Các lần thử lại của cùng một lần gọi cập nhật cùng id và attempts. Một lần gọi mới trong vòng lặp hoặc quy trình con nhận id mới, vì vậy không gộp bản ghi chỉ dựa trên nodeId. Bản ghi được thêm vào cuối theo thứ tự ổn định của lần công bố đầu tiên. Ở mỗi vòng, hãy đọc lại từ page=1 và ghi đè bộ nhớ đệm cục bộ của bạn theo id. Không dùng nodeId, total hoặc trang cuối làm watermark tăng dần. Các trang đọc trong khi lượt chạy đang hoạt động không tạo thành một bản chụp nhanh nhất quán. Sau khi lượt chạy đạt trạng thái kết thúc, hãy đọc tất cả các trang mà không lọc theo trạng thái để đối chiếu. Để biết chi tiết, xem [Quan sát lượt chạy và khôi phục yêu cầu](/vi/browser-rpa/api/observation). Trường data trả về nguyên trạng đầu ra thực tế của nút, không bị che (thông tin xác thực, cookie, giá trị suy ra từ tham số riêng tư và đường dẫn cục bộ đều xuất hiện dưới dạng văn bản thuần). Chỉ các handle ElementRef/FrameRef xuất hiện dưới dạng `{kind,available:false}`, và không thể dùng lại chúng giữa các lượt chạy. Khi có mặt, matchedIndex bắt đầu từ 1.

- **Điều kiện tiên quyết**: Bạn có ID của một lượt chạy mà bạn có quyền đọc.
- **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 ghi thực thi của từng lần gọi nút.
- **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/{runId}/nodes
```

Local API: `http://127.0.0.1:<port>/api/rpa/browser/v1/runs/{runId}/nodes`. 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

| Tham số | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `runId` | string | Có | ID của lượt chạy. Độ dài tối thiểu 1; độ dài tối đa 128. |


### 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. |
| `nodeId` | string | Không | ID nút ổn định trong mẫu. Độ dài tối thiểu 1; độ dài tối đa 128. |
| `workflowRevisionId` | string | Không | ID bản sửa đổi của quy trình gốc hoặc quy trình con mà nút thuộc về. Độ dài tối thiểu 1; độ dài tối đa 128. |
| `invocationPath` | string | Không | Chuỗi không trong suốt (opaque) được sao chép từ items[].invocationPath. Chuỗi được khớp chính xác và cấu trúc của chuỗi không bị phân tích. Độ dài tối thiểu 1; độ dài tối đa 4096. |
| `executionId` | string | Không | Khớp với items[].id, ID bản ghi của một lần gọi nút. Đây không phải là nodeId. Độ dài tối thiểu 1; độ dài tối đa 128. |
| `status` | `running` / `success` / `failed` / `cancelled` | Không | Chỉ một trạng thái thực thi nút duy nhất, không phải trạng thái lượt chạy. Kết hợp với các bộ lọc khác bằng AND. |


### 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/${RPA_RUN_ID}/nodes?page=1&pageSize=20"
```

## Phản hồi

### 200

200 trả về bản ghi thực thi của từng lần gọi nút.

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<[NodeExecution](/vi/browser-rpa/api/data-types#nodeexecution)> | Có | Mảng các mục trên trang hiện tại hoặc trong 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": [
      {
        "dataTruncated": false,
        "id": "node_execution_example",
        "nodeId": "url_result",
        "workflowRevisionId": "revision_example_1",
        "invocationPath": "root",
        "status": "success",
        "attempts": 1,
        "startedAt": 1793318402000,
        "endedAt": 1793318402100,
        "durationMs": 100,
        "data": {
          "value": "https://example.com/",
          "url": "https://example.com/",
          "origin": "https://example.com",
          "pathname": "/",
          "query": {}
        },
        "error": null,
        "artifacts": []
      }
    ],
    "total": 1,
    "page": 1,
    "pageSize": 20
  },
  "meta": {
    "requestId": "7d498f20-7bab-4e59-9b05-88daf51230e9",
    "catalogRevision": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  }
}
```

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

| HTTP | error.code | Cách xử lý |
|  --- | --- | --- |
| 413 | RPA_LIMIT_EXCEEDED | details.limit=nodePageBytes. Hãy giảm pageSize và quét lại từ page=1. Nếu pageSize=1 vẫn vượt quá giới hạn, hãy báo cáo giới hạn này. |


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)

### Ngữ nghĩa thời gian

`durationMs` là thời lượng hành động do trình thực thi ghi nhận. `startedAt` và `endedAt` là thời điểm dịch vụ nhận được trạng thái của nút, nên bao gồm cả chi phí truyền thông điệp và ghi lưu dữ liệu. Đừng kỳ vọng durationMs bằng endedAt−startedAt. Trong kết quả URL, pathname là đường dẫn trang web (chẳng hạn `/fixture`). Đường dẫn tệp cục bộ cũng được trả về nguyên trạng.