# Liệt kê loại nút

> operationId: `listNodeTypes`


## Yêu cầu

Liệt kê các loại nút. Giá trị q được loại bỏ khoảng trắng ở hai đầu và chuyển sang dạng casefold Unicode (không chuẩn hóa NFC/NFKC bổ sung), rồi được so khớp dạng chuỗi con với bất kỳ trường nào trong số id, action, title hoặc description. Giá trị rỗng không lọc. action có giá trị null được coi là chuỗi rỗng. Giá trị category được loại bỏ khoảng trắng ở hai đầu và khớp chính xác, có phân biệt chữ hoa chữ thường. Giá trị rỗng không lọc, còn giá trị không xác định trả về 400. Các phân loại tĩnh hiện tại là browser (hành động) và structure (nút cấu trúc). Trên một instance thực tế, trước tiên bạn có thể truy vấn không kèm bộ lọc để khám phá các phân loại. Hai bộ lọc được kết hợp bằng AND, và kết quả được sắp xếp theo id tăng dần. Danh mục gồm 52 hành động và sáu loại cấu trúc: start, end, group, case, caseDefault và exceptionBlock. Các loại cấu trúc có action=null, điều này không có nghĩa là thiếu trình thực thi. Hãy đánh giá riêng authorable, runtimeSupported, externalRunnable và documentationComplete. Việc một loại nút có trong danh mục không có nghĩa là loại nút đó được phép chạy.

- **Điều kiện tiên quyết**: Bạn đã đọc khả năng. Với category, hãy dùng giá trị thực sự do danh mục nút trả về.
- **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 loại nút 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/node-types
```

Local API: `http://127.0.0.1:<port>/api/rpa/browser/v1/node-types`. 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. |
| `q` | string | Không | Được loại bỏ khoảng trắng ở hai đầu và chuyển sang dạng casefold Unicode (không chuẩn hóa NFC/NFKC), rồi được so khớp dạng chuỗi con với id, action (null được coi là rỗng), title hoặc description; khớp với bất kỳ trường nào cũng được tính. Giá trị rỗng khớp với tất cả. Kết hợp với category bằng AND. Kết quả được sắp xếp theo id tăng dần. Độ dài tối đa 100. |
| `category` | string | Không | Phân loại, được loại bỏ khoảng trắng ở hai đầu và khớp chính xác (phân biệt chữ hoa chữ thường). Giá trị rỗng nghĩa là không lọc. Phân loại không rỗng nhưng không xác định sẽ trả về 400. Độ dài tối đa 100. |


### 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}/node-types?page=1&pageSize=20"
```

## Phản hồi

### 200

200 trả về bản tóm tắt các loại nút 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<[NodeTypeSummary](/vi/browser-rpa/api/data-types#nodetypesummary)> | 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": [
      {
        "id": "browser_waitTime",
        "action": "waitTime",
        "title": "Wait",
        "description": "**Branch rules:** In fixed mode, timeout defaults to 1000ms. In randomInterval mode, the default is [1000,3000]ms, and timeoutMin ≤ timeoutMax.",
        "category": "browser",
        "nodeVersion": 1,
        "authorable": true,
        "runtimeSupported": true,
        "externalRunnable": true,
        "documentationComplete": true,
        "unavailableReasons": []
      }
    ],
    "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)