# Xóa mẫu

> operationId: `deleteTemplate`


## Yêu cầu

Endpoint này xóa một mẫu. Endpoint không có phần thân yêu cầu và không yêu cầu X-RPA-Catalog-Revision. Một mẫu được các mẫu khác ghim làm mẫu con vẫn bị xóa trực tiếp. Thao tác xóa không bị chặn, và các mẫu cha không bị sửa đổi theo kiểu lan truyền. Sau đó, việc xác thực hoặc chạy mẫu cha, hay tạo lịch chạy từ mẫu cha, sẽ trả về 409 RPA_DEPENDENCY_UNAVAILABLE, và phải cập nhật tham chiếu trong mẫu cha. Bản chụp nhanh đã cố định và lịch sử của các lượt chạy và lịch chạy hiện có vẫn được giữ lại. Các lượt chạy mới sẽ không tìm thấy mẫu. Biên nhận xóa ban đầu vẫn có thể được phát lại dù tài nguyên đã bị xóa.

- **Điều kiện tiên quyết**: Bạn đã đọc mẫu đích và ETag của mẫu đó. Hãy xác nhận rằng người dùng đã yêu cầu xóa mẫu này.
- **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 xóa mẫu khỏi Mẫu tùy chỉnh trong ứng dụng (mẫu đám mây cá nhân). Thao tác xóa không lan sang các mẫu cha tham chiếu đến mẫu này, và không hủy các lượt chạy đã cố định hiện có.
- **Tín hiệu hoàn tất**: 200 kèm data.deleted=true nghĩa là việc xóa đã hoàn tất.
- **Thử lại**: Để khôi phục cùng ý định, hãy dùng lại khóa ban đầu, phần thân ban đầu (nếu có) và If-Match ban đầu (khi endpoint yêu cầu). Sau khi hết thời gian chờ HTTP, trước tiên hãy [kiểm tra biên nhận yêu cầu](/vi/browser-rpa/api/get-request-receipt). Không tạo khóa mới.


### Endpoint

```http
DELETE /api/rpa/browser/v1/templates/{templateId}
```

Local API: `http://127.0.0.1:<port>/api/rpa/browser/v1/templates/{templateId}`. 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). |
| `Idempotency-Key` | string | Không | Khuyến nghị. Tạo một UUID cho mỗi ý định ghi mới và giữ nguyên UUID đó khi thử lại sau khi mất kết nối; cùng một khóa không bao giờ được thực thi hai lần. Nếu không có header này thì không có cơ chế chống trùng lặp, nên việc thử lại sau khi hết thời gian chờ có thể thực hiện lại thao tác ghi. Nếu có, giá trị phải là UUID. Định dạng "uuid" |
| `If-Match` | string | Có | ETag chính xác từ phản hồi mẫu. Ký tự đại diện và nhiều giá trị đều bị từ chối. |


### Tham số đường dẫn

| Tham số | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `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, là một chuỗi số). Độ 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 DELETE "${RPA_BASE_URL}/templates/${RPA_TEMPLATE_ID}" \
  -H "Idempotency-Key: ${RPA_REQUEST_KEY}" \
  -H "If-Match: ${RPA_ETAG}"
```

## Phản hồi

### 200

200 kèm data.deleted=true nghĩa là việc xóa đã hoàn tất.

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 |
|  --- | --- | --- | --- |
| `id` | string | Có | ID duy nhất của tài nguyên hoặc nút. Lấy ID từ phản hồi trước đó; không tự đoán. Độ dài tối thiểu 1; độ dài tối đa 128. |
| `deleted` | `true` | Có | Xem định nghĩa mô hình. |


### 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": {
    "id": "template_example",
    "deleted": true
  },
  "meta": {
    "requestId": "7d498f20-7bab-4e59-9b05-88daf51230e9",
    "catalogRevision": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  }
}
```

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

| HTTP | error.code | Cách xử lý |
|  --- | --- | --- |
| 428 | RPA_PRECONDITION_REQUIRED | Thiếu If-Match. Hãy đọc mẫu trước. |
| 412 | RPA_VERSION_CONFLICT | Trước tiên hãy kiểm tra biên nhận ban đầu. Sau khi xác nhận yêu cầu chưa được commit, hãy đọc lại mẫu và hợp nhất, rồi dùng khóa mới cho ý định đã sửa đổi. |
| 409 | RPA_REQUEST_CONFLICT | Phương thức/đường dẫn/phần thân/If-Match gửi kèm cùng khóa khác với ý định ban đầu. |
| 504 | RPA_REQUEST_TIMEOUT | Lỗi này chỉ có nghĩa là thời gian chờ HTTP đã hết. Trước tiên hãy kiểm tra biên nhận của yêu cầu ban đầu. |


Khi phát lại một thao tác ghi bằng cùng khóa, ETag của phản hồi ban đầu được giữ nguyên (nếu có; ETag này có thể đã cũ). Biên nhận chỉ chứa dữ liệu, không có header phản hồi. Để tiếp tục chỉnh sửa, trước tiên hãy gửi một yêu cầu GET; xem [Quy ước API](/vi/browser-rpa/api/common).

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)