# Lấy khả năng

> operationId: `getCapabilities`


## Yêu cầu

Lấy các khả năng RPA. Mảng operations chỉ liệt kê các operationId thực sự đã được đăng ký và được cấp quyền tại thời điểm này. Hãy ghi lại catalogRevision. Các yêu cầu ghi về sau có biên dịch quy trình phải gửi kèm giá trị này. Bản chụp nhanh khả năng không phải là quyền được cấp vĩnh viễn. Việc lưu, xác thực và bắt đầu lượt chạy đều kiểm tra lại.

- **Điều kiện tiên quyết**: Ứng dụng máy tính đã bật Local API của RPA, và thông tin xác thực hợp lệ.
- **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ụ và không khởi động trình duyệt.
- **Tín hiệu hoàn tất**: 200 nghĩa là bạn đã nhận được bản chụp nhanh các khả năng có sẵn cho ứng dụng đang đăng nhập.
- **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/capabilities
```

Local API: `http://127.0.0.1:<port>/api/rpa/browser/v1/capabilities`. 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

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}/capabilities"
```

## Phản hồi

### 200

200 nghĩa là bạn đã nhận được bản chụp nhanh các khả năng có sẵn cho ứng dụng đang đăng nhập.

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 |
|  --- | --- | --- | --- |
| `apiVersion` | `"v1"` | Có | Phiên bản chính của HTTP API. |
| `schemaVersion` | string | Có | Phiên bản của hợp đồng soạn thảo (semver). |
| `catalogRevision` | string | Có | Bản sửa đổi nội dung của các hợp đồng nút. Định dạng: sha256: theo sau là 64 chữ số thập lục phân. |
| `editorVersions` | array<integer> | Có | Danh sách các phiên bản trình chỉnh sửa hiện được chấp nhận. |
| `parameterVersions` | array<`1`> | Có | Danh sách các phiên bản tham số hiện có thể ghi qua API công khai. |
| `operations` | array<string> | Có | Mảng các operationId đã được đăng ký trên instance này và được cấp quyền cho ứng dụng hiện tại. |
| `runtimeProfile` | `"v1"` | Có | Chính sách thực thi từ bên ngoài: giống như lượt chạy trong ứng dụng, không có hạn chế bổ sung nào về nút, trường hoặc tham số. |
| `limits` | object | Có | Giới hạn đang có hiệu lực. Hãy dùng các giá trị trong phản hồi. |
| `docs` | object | Có | Các URL tài liệu cùng origin, tương ứng với khả năng hiện tại. URL bắt đầu bằng / được phân giải theo origin cục bộ. |


**Các trường của `limits`**

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `limits.requestBytes` | integer | Có | Kích thước tối đa của phần thân HTTP, tính bằng byte. Tối thiểu 1. |
| `limits.workflowBytes` | integer | Có | Kích thước tối đa của quy trình khi được tuần tự hóa dạng gọn, tính bằng byte. Tối thiểu 1. |
| `limits.maxNodes` | integer | Có | Số nút tối đa trên mỗi mẫu, bao gồm cả vùng chứa. Tối thiểu 1. |
| `limits.maxDepth` | integer | Có | Độ sâu lồng nhau tối đa. Tối thiểu 1. |
| `limits.maxEdits` | integer | Có | Số thao tác tối đa trong một lần chỉnh sửa nút. Tối thiểu 1. |
| `limits.maxIssues` | integer | Có | Số vấn đề tối đa được trả về trong một lần. Tối thiểu 1. |
| `limits.requestsPerMinute` | integer | Có | Số yêu cầu tối đa mỗi phút cho ứng dụng đang đăng nhập. Tối thiểu 1. |
| `limits.maxInFlightWrites` | integer | Có | Số thao tác ghi đang xử lý đồng thời tối đa cho ứng dụng đang đăng nhập. Tối thiểu 1. |
| `limits.nodeDataBytes` | integer | Có | Kích thước tối đa của một giá trị data trong bản ghi thực thi nút, tính bằng byte của JSON UTF-8 dạng gọn. Mặc định 65536. Giá trị vượt giới hạn sẽ bị lược bỏ toàn bộ. Tối thiểu 1. |
| `limits.nodePageBytes` | integer | Có | Kích thước tối đa của một trang hoàn chỉnh gồm các bản ghi thực thi nút, tính bằng byte của JSON UTF-8 dạng gọn. Mặc định 8388608. Trang vượt giới hạn sẽ trả về 413. Đây không phải là giới hạn của phần thân yêu cầu. Tối thiểu 1. |


**Các trường của `docs`**

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `docs.openapi` | string | Có | URL của tài liệu dạng máy đọc được cho HTTP API cục bộ. |
| `docs.schema` | string | Có | URL của tài liệu workflow.schema.json tương ứng với bản sửa đổi danh mục. |
| `docs.aiGuide` | string | Có | URL của hướng dẫn thao tác dành cho AI. |
| `docs.nodeIndex` | string | Có | URL của danh mục nút. |
| `docs.examples` | string | Có | URL của tài liệu ví dụ đầy đủ. |


### 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": {
    "apiVersion": "v1",
    "schemaVersion": "1.0.0",
    "catalogRevision": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    "editorVersions": [
      2
    ],
    "parameterVersions": [
      1
    ],
    "operations": [
      "getCapabilities",
      "listNodeTypes",
      "getNodeType",
      "validateWorkflow",
      "listTemplates",
      "createTemplate",
      "getTemplate",
      "replaceTemplate",
      "deleteTemplate",
      "copyTemplate",
      "listTemplateNodes",
      "editTemplateNodes",
      "startRun",
      "listRuns",
      "getRun",
      "cancelRun",
      "listRunNodes",
      "listRunArtifacts",
      "getRequestReceipt"
    ],
    "runtimeProfile": "v1",
    "limits": {
      "requestBytes": 5242880,
      "workflowBytes": 4194304,
      "maxNodes": 1000,
      "maxDepth": 32,
      "maxEdits": 100,
      "maxIssues": 200,
      "requestsPerMinute": 60,
      "maxInFlightWrites": 4,
      "nodeDataBytes": 65536,
      "nodePageBytes": 8388608
    },
    "docs": {
      "openapi": "/api/rpa/browser/v1/openapi.json",
      "schema": "/api/rpa/browser/v1/docs/api/workflow.schema.json",
      "aiGuide": "/api/rpa/browser/v1/docs/SKILL.md",
      "nodeIndex": "/api/rpa/browser/v1/docs/api/node-contracts.md",
      "examples": "/api/rpa/browser/v1/docs/api/complete-example.md"
    }
  },
  "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)