Source: https://ailoot.ai/docs/vi/cabinet/redeem/
Canonical: https://ailoot.ai/docs/vi/cabinet/redeem/
Language: vi

[API bảng điều khiển](https://ailoot.ai/docs/vi/) 

# Mã nạp tiền

[Markdown](https://ailoot.ai/docs/vi/cabinet/redeem/index.md)

Phương thức, trường yêu cầu và phản hồi.

Phần này có 2 phương thức. Mở phương thức để xem điều kiện truy cập, trường yêu cầu và phản hồi.

| Phương thức và đường dẫn | Mô tả | Quyền truy cập |
| --- | --- | --- |
| `POST /api/v1/redeem` | Đổi mã | Token trang quản lý tài khoản |
| `GET /api/v1/redeem/history` | Lịch sử đổi mã | Token trang quản lý tài khoản |

**POST /api/v1/redeem** — Đổi mã

Quyền truy cập: Token trang quản lý tài khoản

POST`/api/v1/redeem`

## Các trường JSON / biểu mẫu

| Trường | Kiểu | Bắt buộc | Kiểm tra / mô tả |
| --- | --- | --- | --- |
| `code` | `string` | có | required |

Mẫu nội dung yêu cầu

```json
{
  "code": "PLACEHOLDER_CODE (string)"
}
```

PLACEHOLDER biểu thị dữ liệu bạn nhập và kiểu dữ liệu đó. Thay các giá trị và chỉ giữ những trường tùy chọn cần thiết; không gửi chuỗi đánh dấu thay cho số, boolean, đối tượng hoặc mảng.

Lược đồ yêu cầu: `RedeemRequest`

## Phản hồi

Phản hồi JSON chứa code, message và data. Nội dung data được mô tả trong các lược đồ bên dưới.

Lược đồ dữ liệu phản hồi: `RedeemCode`. Các trường và kiểu dữ liệu nằm trên trang “Lược đồ dữ liệu”.

Lược đồ phản hồi, các giá trị chỉ để minh họa

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "id": "PLACEHOLDER_ID (integer)",
    "code": "PLACEHOLDER_CODE (string)",
    "type": "PLACEHOLDER_TYPE (string)",
    "value": "PLACEHOLDER_VALUE (number)",
    "status": "PLACEHOLDER_STATUS (string)",
    "used_by": "PLACEHOLDER_USED_BY (integer)",
    "used_at": "PLACEHOLDER_USED_AT (string)",
    "created_at": "PLACEHOLDER_CREATED_AT (string)",
    "expires_at": "PLACEHOLDER_EXPIRES_AT (string)",
    "validity_days": "PLACEHOLDER_VALIDITY_DAYS (integer)",
    "notes": "PLACEHOLDER_NOTES (string)",
    "user": "PLACEHOLDER_USER (object)"
  }
}
```

Đặc điểm: Mọi dữ liệu cá nhân và đối tượng đều được giới hạn theo chủ thể JWT.

Đặc điểm: Thao tác thay đổi trạng thái hoặc tiếp tục quy trình ủy quyền dùng một lần; ví dụ mô tả hợp đồng và không được thực thi.

Phương thức thay đổi dữ liệu. Chỉ an toàn khi gửi lại nếu phương thức có ghi Idempotency-Key. Nếu mất phản hồi, trước tiên hãy kiểm tra kết quả (chẳng hạn danh sách khóa), rồi mới quyết định có gửi lại yêu cầu hay không.

**GET /api/v1/redeem/history** — Lịch sử đổi mã

Quyền truy cập: Token trang quản lý tài khoản

GET`/api/v1/redeem/history`

Đọc; lấy ID từ phản hồi trước đó của bạn

```bash
curl --fail-with-body "https://ailoot.ai/api/v1/redeem/history" \
  -H "Authorization: Bearer $TOKEN"
```

## Tham số truy vấn

| Trường | Kiểu | Bắt buộc | Kiểm tra / mô tả |
| --- | --- | --- | --- |
| `page` | `integer` | không | ; mặc định: 1; positive integer |
| `page_size` | `integer` | không | ; mặc định: 20; positive; clamp to100 |

Không cần nội dung yêu cầu. Gửi các tham số nêu trên trong URL.

## Phản hồi

Phản hồi JSON chứa code, message và data. Nội dung data được mô tả trong các lược đồ bên dưới.

Lược đồ dữ liệu phản hồi: `RedeemCode`. Các trường và kiểu dữ liệu nằm trên trang “Lược đồ dữ liệu”.

Lược đồ phản hồi, các giá trị chỉ để minh họa

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "items": [
      {
        "id": "PLACEHOLDER_ID (integer)",
        "code": "PLACEHOLDER_CODE (string)",
        "type": "PLACEHOLDER_TYPE (string)",
        "value": "PLACEHOLDER_VALUE (number)",
        "status": "PLACEHOLDER_STATUS (string)",
        "used_by": "PLACEHOLDER_USED_BY (integer)",
        "used_at": "PLACEHOLDER_USED_AT (string)",
        "created_at": "PLACEHOLDER_CREATED_AT (string)",
        "expires_at": "PLACEHOLDER_EXPIRES_AT (string)",
        "validity_days": "PLACEHOLDER_VALIDITY_DAYS (integer)",
        "notes": "PLACEHOLDER_NOTES (string)",
        "user": "PLACEHOLDER_USER (object)"
      }
    ],
    "total": "PLACEHOLDER_TOTAL (integer)",
    "page": "PLACEHOLDER_PAGE (integer)",
    "page_size": "PLACEHOLDER_PAGE_SIZE (integer)",
    "pages": "PLACEHOLDER_PAGES (integer)"
  }
}
```

Đặc điểm: Mọi dữ liệu cá nhân và đối tượng đều được giới hạn theo chủ thể JWT.

Còn câu hỏi? Hãy gửi Request ID và mô tả — chúng tôi sẽ giúp tìm hiểu.[Liên hệ hỗ trợ](mailto:support@ailoot.ai)

## Ailoot · Công ty và danh mục dự án của công ty





Ailoot dựa trên kinh nghiệm vận hành tích lũy, cơ sở khách hàng lớn, dịch vụ ổn định và việc kiểm soát KPI liên tục.





Công ty và danh mục dự án của công ty: hàng triệu khách hàng; doanh số hàng tỷ mỗi tháng.





Ailoot áp dụng kinh nghiệm vận hành này để cung cấp quyền truy cập API vào các tính năng AI trong sản phẩm của khách hàng, tác tử, ứng dụng và quy trình tự động hóa.