# Liệt kê nút của mẫu

> operationId: `listTemplateNodes`


## Yêu cầu

Liệt kê các nút của một mẫu. Trường items[].id là ID ổn định dùng để chỉnh sửa. parentId là null nghĩa là cấp gốc. Trường path là một JSON Pointer tương đối so với quy trình; khi chỉnh sửa, không dùng path hoặc chỉ số mảng thay cho nodeId. Trường node bao gồm cả các khối (blocks) của nút, và danh sách cũng liệt kê riêng các nút con. Trước khi thay đổi, hãy đọc chi tiết mẫu để lấy ETag. Nếu phiên bản đã thay đổi, hãy xác định lại vị trí các nút.

- **Điều kiện tiên quyết**: Bạn đã xác định được một mẫu 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ề danh sách nút theo thứ tự duyệt theo chiều sâu và templateVersion.
- **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/templates/{templateId}/nodes
```

Local API: `http://127.0.0.1:<port>/api/rpa/browser/v1/templates/{templateId}/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 |
|  --- | --- | --- | --- |
| `templateId` | string | Có | ID mẫu đích (ID đám mây của mẫu trong Mẫu tùy chỉnh của ứng dụng máy tính, là một chuỗi số). Độ dài tối thiểu 1; độ dài tối đa 128. |


### Tham số truy vấn

Không có.

### 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}/templates/${RPA_TEMPLATE_ID}/nodes"
```

## Phản hồi

### 200

200 trả về danh sách nút theo thứ tự duyệt theo chiều sâu và templateVersion.

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<object> | 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. |
| `templateVersion` | integer | Có | Phiên bản mẫu tại thời điểm truy vấn cây nút này. Tối thiểu 1. |


**Các trường của `items[]`**

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `items[].id` | string | Có | ID duy nhất của tài nguyên hoặc nút. Lấy ID từ phản hồi trước đó; không tự đoán. Độ dài tối thiểu 1; độ dài tối đa 128. |
| `items[].parentId` | string hoặc null | Có | ID của vùng chứa cha đích; null nghĩa là cấp gốc. |
| `items[].path` | string | Có | JSON Pointer tương đối so với gốc quy trình, chẳng hạn /nodes/1. Đây không phải là issue.path của phần thân yêu cầu. |
| `items[].node` | [Cấu trúc quy trình](/vi/browser-rpa/api/workflow) / [JSON Schema](/vi/browser-rpa/local-api#h%E1%BB%A3p-%C4%91%E1%BB%93ng-c%E1%BB%A5c-b%E1%BB%99-d%E1%BA%A1ng-m%C3%A1y-%C4%91%E1%BB%8Dc-%C4%91%C6%B0%E1%BB%A3c) | Có | Đối tượng nút hoàn chỉnh, bao gồm mọi khối cần giữ lại. |


### 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": "start",
        "parentId": null,
        "path": "/nodes/0",
        "node": {
          "id": "start",
          "type": "start"
        }
      },
      {
        "id": "visit",
        "parentId": null,
        "path": "/nodes/1",
        "node": {
          "id": "visit",
          "type": "browser_gotoUrl",
          "data": {
            "browserAction": "gotoUrl",
            "browserUi": {
              "inputs": {
                "url": "${targetUrl}",
                "postWaitMs": 500
              }
            }
          }
        }
      },
      {
        "id": "url_result",
        "parentId": null,
        "path": "/nodes/2",
        "node": {
          "id": "url_result",
          "type": "browser_getUrl",
          "data": {
            "browserAction": "getUrl",
            "browserUi": {
              "inputs": {
                "type": "href"
              }
            }
          }
        }
      },
      {
        "id": "end",
        "parentId": null,
        "path": "/nodes/3",
        "node": {
          "id": "end",
          "type": "end",
          "data": {
            "inputsValues": {
              "status": {
                "type": "constant",
                "content": "success"
              },
              "message": {
                "type": "ref",
                "content": [
                  "url_result",
                  "data",
                  "value"
                ]
              }
            }
          }
        }
      }
    ],
    "templateVersion": 1
  },
  "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)