# Liệt kê tạo phẩm của lượt chạy

> operationId: `listRunArtifacts`


## Yêu cầu

Endpoint này liệt kê các tạo phẩm của lượt chạy. Trường path là đường dẫn cục bộ tuyệt đối mà nút đã thực sự ghi vào (ảnh chụp màn hình, tệp tải xuống, tệp Excel được xuất, dữ liệu đã lưu, v.v.). Tệp vẫn ở nguyên vị trí và không bị sao chép hay lưu trữ. Nếu sau đó tệp bị di chuyển hoặc xóa, giá trị path vẫn được giữ lại, vì vậy hãy xác nhận tệp tồn tại trước khi đọc. Trường contentAvailable hiện luôn là false, và không có endpoint tải xuống. Trường size tính bằng byte và ghi lại kích thước tại thời điểm ghi. Mỗi lượt chạy chỉ có một bản ghi tạo phẩm cho mỗi đường dẫn. Khi cùng một tệp được ghi lại, bản ghi giữ nguyên id ban đầu, còn size và createdAt được cập nhật theo giá trị của lần ghi cuối cùng.

- **Điều kiện tiên quyết**: Bạn đã có ID của một lượt chạy 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ụ**: Lệnh gọi này chỉ đọc siêu dữ liệu. Lệnh gọi không tải xuống hay mở tệp.
- **Tín hiệu hoàn tất**: 200 trả về mảng siêu dữ liệu tạo phẩm trong data.items. data.items=[] nghĩa là hiện không có tạo phẩm công khai nào.
- **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}/artifacts
```

Local API: `http://127.0.0.1:<port>/api/rpa/browser/v1/runs/{runId}/artifacts`. 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 mà các tạo phẩm thuộc về. Độ 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}/artifacts"
```

## Phản hồi

### 200

200 trả về mảng siêu dữ liệu tạo phẩm trong data.items. data.items=[] nghĩa là hiện không có tạo phẩm công khai nào.

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<[ArtifactMetadata](/vi/browser-rpa/api/data-types#artifactmetadata)> | Có | Mảng các mục trên trang hiện tại hoặc của tài nguyên hiện tạ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": "artifact_example",
        "runId": "run_example",
        "name": "screenshot-1793318403000.png",
        "path": "/Users/example/Downloads/screenshot-1793318403000.png",
        "mimeType": "image/png",
        "size": 10240,
        "createdAt": 1793318403000,
        "contentAvailable": false
      }
    ]
  },
  "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)