# Lấy biên nhận yêu cầu

> operationId: `getRequestReceipt`


## Yêu cầu

Endpoint này trả về kết quả xử lý của một yêu cầu. Khi state là completed, result là dữ liệu nghiệp vụ ban đầu, còn originalStatus là trạng thái HTTP ban đầu. Biên nhận của thao tác ghi mẫu không lưu nội dung mẫu. Khi phát lại (bao gồm cả kết quả của endpoint này), máy chủ đọc lại mẫu đám mây và trả về nội dung hiện tại của mẫu, giống như GET. Khi một thao tác ghi mẫu đám mây không nhận được xác nhận, biên nhận có state=unknown và safeError.code=RPA_OUTCOME_UNKNOWN. Thử lại với cùng khóa sẽ không ghi lại lần nữa. Trước tiên hãy kiểm tra danh sách mẫu. Với accepted, hãy truy vấn lại sau khoảng 3 giây. Với committed, hãy chờ đến khi việc công bố được khôi phục. Với unknown, hãy kiểm tra thủ công và không chạy lại bằng khóa khác. Chỉ phản hồi 404 RPA_REQUEST_NOT_COMMITTED kèm error.details.safeToRetrySameKey=true mới có nghĩa là yêu cầu đã được xác nhận là chưa commit sau khi khôi phục hoàn toàn. Phản hồi 404 thông thường không mang ý nghĩa này. Có thể phát lại đầy đủ trong 24 giờ. Trong 30 ngày sau đó, bản ghi tombstone trả về 410.

- **Điều kiện tiên quyết**: Yêu cầu ban đầu có kèm Idempotency-Key (yêu cầu gửi đi mà không có khóa thì không có biên nhận để truy vấn). Dùng Idempotency-Key ban đầu, với thông tin xác thực thuộc tài khoản/nhóm ban đầu. Việc thay đổi token xác thực không ảnh hưởng đến biên nhận của cùng tài khoản/nhóm.
- **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ụ**: Lệnh gọi này chỉ truy vấn trạng thái của ý định ban đầu. Lệnh gọi không gửi lại lệnh.
- **Tín hiệu hoàn tất**: 200 trả về accepted/committed/completed/failed/unknown. Hãy khôi phục theo trạng thái, và không coi việc tìm thấy biên nhận là thành công về mặt nghiệp vụ.
- **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/requests/{key}
```

Local API: `http://127.0.0.1:<port>/api/rpa/browser/v1/requests/{key}`. 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 |
|  --- | --- | --- | --- |
| `key` | string | Có | UUID dùng làm Idempotency-Key của ý định ghi ban đầu. Định dạng "uuid" |


### 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.

Biên nhận và tài nguyên chỉ hiển thị trong phạm vi dữ liệu của tài khoản/nhóm/thành viên ban đầu. Sau khi bạn chuyển tài khoản, nhóm hoặc thành viên, bạn đang dùng một kho lưu trữ khác. Việc không tìm thấy biên nhận cũ ở đó không chứng minh rằng yêu cầu ban đầu chưa được thực thi. Việc thay đổi token xác thực không làm thay đổi phạm vi dữ liệu hiện tại. RPA không có cơ chế cấp quyền hay thu hồi quyền riêng cho từng tài nguyên.

### 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}/requests/${RPA_ORIGINAL_KEY}"
```

## Phản hồi

### 200

200 trả về accepted/committed/completed/failed/unknown. Hãy khôi phục theo trạng thái, và không coi việc tìm thấy biên nhận là thành công về mặt nghiệp vụ.

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 |
|  --- | --- | --- | --- |
| `key` | string | Có | UUID dùng làm Idempotency-Key của ý định ghi ban đầu. Định dạng "uuid". |
| `operation` | string | Có | operationId của thao tác nghiệp vụ ban đầu. |
| `state` | `accepted` / `committed` / `completed` / `failed` / `unknown` | Có | Trạng thái đăng ký/commit/công bố của ý định ghi ban đầu. Đây không phải là trạng thái thực thi của lượt chạy. |
| `createdAt` | integer | Có | Thời điểm tạo, tính bằng mili giây Unix. Tối thiểu 0. |
| `updatedAt` | integer | Có | Thời điểm cập nhật gần nhất, tính bằng mili giây Unix. Tối thiểu 0. |
| `replayAvailable` | boolean | Có | Cho biết biên nhận còn nằm trong khoảng thời gian phát lại đầy đủ hay không. |
| `resourceId` | string hoặc null | Có | ID của tài nguyên mà thao tác ban đầu đã tạo hoặc tác động lên. Có thể là null. |
| `originalStatus` | integer hoặc null | Có | Mã trạng thái HTTP ban đầu. Có thể là null. |
| `result` | [JsonValue](/vi/browser-rpa/api/data-types#jsonvalue) | Có | Phần data của phản hồi thành công ban đầu, không có header/ETag. Là null khi chưa tạo ra kết quả nào hoặc trạng thái là failed. |
| `safeError` | [PublicError](/vi/browser-rpa/api/data-types#publicerror) | Không | code/message công khai của biên nhận failed, không kèm stack trace nội bộ. |


### 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": {
    "key": "8aefcc5a-dce8-4e5b-a494-26f404475850",
    "operation": "createTemplate",
    "state": "completed",
    "createdAt": 1793318400000,
    "updatedAt": 1793318400000,
    "replayAvailable": true,
    "resourceId": "template_example",
    "originalStatus": 201,
    "result": {
      "title": "Read the page URL",
      "description": "Visit the given page and return its URL",
      "workflow": {
        "editorVersion": 2,
        "editorParametersVersion": 1,
        "variables": {
          "type": "object",
          "properties": {
            "targetUrl": {
              "type": "string",
              "description": "HTTP(S) URL to visit"
            }
          },
          "required": [
            "targetUrl"
          ]
        },
        "nodes": [
          {
            "id": "start",
            "type": "start"
          },
          {
            "id": "visit",
            "type": "browser_gotoUrl",
            "data": {
              "browserAction": "gotoUrl",
              "browserUi": {
                "inputs": {
                  "url": "${targetUrl}",
                  "postWaitMs": 500
                },
                "bindings": {},
                "exception": {
                  "policy": "interrupt",
                  "timeout": 30000,
                  "retry": false,
                  "retryTimes": 1,
                  "retryInterval": 2,
                  "screenshot": true
                }
              },
              "title": "Visit website",
              "inputs": {
                "type": "object",
                "properties": {}
              },
              "inputsValues": {},
              "outputs": {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "string",
                    "description": "Execution status"
                  },
                  "startedAt": {
                    "type": "string",
                    "description": "Start time"
                  },
                  "endedAt": {
                    "type": "string",
                    "description": "End time"
                  },
                  "durationMs": {
                    "type": "number",
                    "description": "Duration (ms)"
                  },
                  "matchedIndex": {
                    "type": "number",
                    "description": "Match index"
                  },
                  "error": {
                    "type": "object",
                    "description": "Error message",
                    "properties": {
                      "code": {
                        "type": "string"
                      },
                      "message": {
                        "type": "string"
                      }
                    }
                  },
                  "data": {
                    "type": "object",
                    "description": "Result",
                    "properties": {
                      "tabId": {
                        "type": "string",
                        "description": "Tab ID"
                      },
                      "httpStatus": {
                        "type": "number",
                        "description": "HTTP status code"
                      },
                      "url": {
                        "type": "string",
                        "description": "URL"
                      },
                      "finalUrl": {
                        "type": "string",
                        "description": "Final URL"
                      },
                      "title": {
                        "type": "string",
                        "description": "Page title"
                      },
                      "isRedirected": {
                        "type": "boolean",
                        "description": "Redirected"
                      }
                    }
                  }
                }
              }
            }
          },
          {
            "id": "url_result",
            "type": "browser_getUrl",
            "data": {
              "browserAction": "getUrl",
              "browserUi": {
                "inputs": {
                  "type": "href"
                },
                "bindings": {},
                "exception": {
                  "policy": "interrupt",
                  "timeout": 30000,
                  "retry": false,
                  "retryTimes": 1,
                  "retryInterval": 2,
                  "screenshot": true
                }
              },
              "title": "Get URL",
              "inputs": {
                "type": "object",
                "properties": {}
              },
              "inputsValues": {},
              "outputs": {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "string",
                    "description": "Execution status"
                  },
                  "startedAt": {
                    "type": "string",
                    "description": "Start time"
                  },
                  "endedAt": {
                    "type": "string",
                    "description": "End time"
                  },
                  "durationMs": {
                    "type": "number",
                    "description": "Duration (ms)"
                  },
                  "matchedIndex": {
                    "type": "number",
                    "description": "Match index"
                  },
                  "error": {
                    "type": "object",
                    "description": "Error message",
                    "properties": {
                      "code": {
                        "type": "string"
                      },
                      "message": {
                        "type": "string"
                      }
                    }
                  },
                  "data": {
                    "type": "object",
                    "description": "Result",
                    "properties": {
                      "url": {
                        "type": "string",
                        "description": "URL"
                      },
                      "origin": {
                        "type": "string",
                        "description": "Origin"
                      },
                      "pathname": {
                        "type": "string",
                        "description": "Path"
                      },
                      "query": {
                        "type": "object",
                        "properties": {},
                        "description": "Query parameters"
                      }
                    }
                  }
                }
              }
            }
          },
          {
            "id": "end",
            "type": "end",
            "data": {
              "inputsValues": {
                "status": {
                  "type": "constant",
                  "content": "success"
                },
                "message": {
                  "type": "ref",
                  "content": [
                    "url_result",
                    "data",
                    "value"
                  ]
                }
              }
            }
          }
        ]
      },
      "dependencies": [],
      "id": "template_example",
      "version": 1,
      "revisionId": "revision_example_1",
      "createdAt": 1793318400000,
      "updatedAt": 1793318400000,
      "warnings": [],
      "redactedPaths": []
    }
  },
  "meta": {
    "requestId": "7d498f20-7bab-4e59-9b05-88daf51230e9",
    "catalogRevision": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  }
}
```

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

| HTTP | error.code | Cách xử lý |
|  --- | --- | --- |
| 404 | RPA_REQUEST_NOT_COMMITTED | Chỉ khôi phục bằng khóa ban đầu khi error.details.safeToRetrySameKey=true. |
| 410 | RPA_REQUEST_EXPIRED | Thời hạn phát lại kết quả ban đầu đã hết. Hãy kiểm tra resourceId vẫn còn đọc được, và quyết định thủ công xem có cần ý định mới hay không. |
| 503 | RPA_JOURNAL_PENDING | Quá trình khôi phục hoặc công bố chưa hoàn tất. Hãy giữ nguyên khóa ban đầu và truy vấn 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)