Mã nạp tiền

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

Hướng dẫn đầy đủ

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

{
  "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

{
  "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.

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

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.