# Lấy chi tiết lượt chạy

> operationId: `getRun`


## Yêu cầu

Lấy chi tiết của một lượt chạy. result là null nghĩa là chưa có kết quả. Với trạng thái kết thúc, hãy kiểm tra thêm outputs, error, hasNodeErrors và isolation. Với mọi trạng thái kết thúc khác success, hãy báo cáo kèm lý do thực tế. Khi trạng thái là failed và error.code là OUTCOME_UNKNOWN, không tự động chạy lại. Trường result.outputs trả về nguyên trạng giá trị thực tế, không bị che (xem [Ranh giới dữ liệu và thực thi](/vi/browser-rpa/api/common#ranh-gi%E1%BB%9Bi-d%E1%BB%AF-li%E1%BB%87u-v%C3%A0-th%E1%BB%B1c-thi)). Trường snapshot chỉ chứa định danh bản sửa đổi. Trường này không trả về toàn bộ nội dung gốc, tham số riêng tư, debug hoặc rawResult.

- **Điều kiện tiên quyết**: runId lấy từ phản hồi bắt đầu lượt chạy hoặc từ danh sách lượt chạy trong phạm vi bạn được cấp quyền.
- **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ề lượt chạy hiện tại, kết quả của lượt chạy và các phiên bản đã được cố định. Phản hồi này không đảm bảo rằng lượt chạy đã kết thúc.
- **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}
```

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

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}/runs/${RPA_RUN_ID}"
```

## Phản hồi

### 200

200 trả về lượt chạy hiện tại, kết quả của lượt chạy và các phiên bản đã được cố định. Phản hồi này không đảm bảo rằng lượt chạy đã kết thúc.

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 |
|  --- | --- | --- | --- |
| `run` | [RunSummary](/vi/browser-rpa/api/data-types#runsummary) | Có | Bản tóm tắt lượt chạy hiện tại. |
| `result` | object hoặc null | Có | Kết quả lượt chạy; là null nếu chưa có kết quả. outputs là ánh xạ các đầu ra của quy trình. Nếu lượt chạy thất bại trước khi bắt đầu thực thi (ví dụ, một yêu cầu lên đám mây thất bại trong khi đang phân giải môi trường), result.outputs là một đối tượng rỗng và result.error là lý do thất bại. |
| `snapshot` | object | Có | Bản tóm tắt các bản sửa đổi mẫu và phụ thuộc đã được cố định, không kèm nội dung gốc. |


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

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `result.outputs` | [JsonObject](/vi/browser-rpa/api/data-types#jsonobject) | Có | Đầu ra của quy trình. Giá trị thực tế được trả về nguyên trạng (không bị che). |
| `result.error` | [PublicError](/vi/browser-rpa/api/data-types#publicerror) hoặc null | Có | Đối tượng lỗi công khai, hoặc null. |


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

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `snapshot.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. |
| `snapshot.version` | integer | Có | Phiên bản mẫu có thể chỉnh sửa hiện tại. Đọc giá trị này từ phản hồi thực tế. Tối thiểu 1. |
| `snapshot.revisionId` | string | Có | ID bản sửa đổi bất biến. Độ dài tối thiểu 1; độ dài tối đa 128. |
| `snapshot.dependencyRevisions` | array<[DependencyPin](/vi/browser-rpa/api/data-types#dependencypin)> | Có | Các bản sửa đổi phụ thuộc chính xác được dùng để cố định hoặc xác thực. |


### 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": {
    "run": {
      "id": "run_example",
      "status": "success",
      "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": 1793318401000,
      "endedAt": 1793318403000,
      "startAfter": null,
      "hasNodeErrors": false,
      "isolation": null
    },
    "result": {
      "outputs": {
        "result": "https://example.com/"
      },
      "error": null
    },
    "snapshot": {
      "templateId": "template_example",
      "version": 1,
      "revisionId": "revision_example_1",
      "dependencyRevisions": []
    }
  },
  "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)