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

[API panel pengguna](https://ailoot.ai/docs/ms/) 

# Kod tambah nilai

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

Kaedah, medan permintaan dan respons.

Bahagian ini mengandungi 2 kaedah. Buka kaedah untuk melihat syarat akses, medan permintaan dan respons.

| Kaedah dan laluan | Penerangan | Akses |
| --- | --- | --- |
| `POST /api/v1/redeem` | Penebusan kod | Token panel pengguna |
| `GET /api/v1/redeem/history` | Sejarah penebusan | Token panel pengguna |

**POST /api/v1/redeem** — Penebusan kod

Akses: Token panel pengguna

POST`/api/v1/redeem`

## Medan JSON / borang

| Medan | Jenis | Wajib | Pengesahan / penerangan |
| --- | --- | --- | --- |
| `code` | `string` | ya | required |

Templat badan permintaan

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

PLACEHOLDER mewakili input anda dan jenisnya. Gantikan nilai dan kekalkan hanya medan pilihan yang diperlukan; penanda rentetan tidak boleh dihantar sebagai ganti nombor, boolean, objek atau tatasusunan.

Skema permintaan: `RedeemRequest`

## Respons

Respons JSON mengandungi code, message dan data. Kandungan data diterangkan dalam skema di bawah.

Skema data respons: `RedeemCode`. Medan dan jenisnya terdapat pada halaman “Skema data”.

Skema respons, nilai hanyalah contoh

```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)"
  }
}
```

Nota khusus: Semua data peribadi dan objek dihadkan kepada subjek JWT.

Nota khusus: Operasi mengubah keadaan atau meneruskan pengesahan sekali guna; contoh ini menerangkan kontrak dan tidak dijalankan.

Kaedah ini mengubah data. Penghantaran semula hanya selamat jika Idempotency-Key dinyatakan pada kaedah. Jika respons hilang, semak hasil terlebih dahulu (contohnya, senarai kunci), kemudian tentukan sama ada permintaan perlu dihantar semula.

**GET /api/v1/redeem/history** — Sejarah penebusan

Akses: Token panel pengguna

GET`/api/v1/redeem/history`

Baca sahaja; ID diambil daripada respons anda yang terdahulu

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

## Parameter pertanyaan

| Medan | Jenis | Wajib | Pengesahan / penerangan |
| --- | --- | --- | --- |
| `page` | `integer` | tidak | ; nilai lalai: 1; positive integer |
| `page_size` | `integer` | tidak | ; nilai lalai: 20; positive; clamp to100 |

Badan permintaan tidak diperlukan. Hantar parameter yang dinyatakan di atas dalam URL.

## Respons

Respons JSON mengandungi code, message dan data. Kandungan data diterangkan dalam skema di bawah.

Skema data respons: `RedeemCode`. Medan dan jenisnya terdapat pada halaman “Skema data”.

Skema respons, nilai hanyalah contoh

```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)"
  }
}
```

Nota khusus: Semua data peribadi dan objek dihadkan kepada subjek JWT.

Masih ada soalan? Hantar Request ID dan penerangannya — kami akan membantu menyiasatnya.[Hubungi sokongan](mailto:support@ailoot.ai)

## Ailoot · Syarikat dan portfolio projeknya





Ailoot berteraskan pengalaman operasi yang mantap, pangkalan pelanggan yang besar, perkhidmatan yang stabil dan pemantauan KPI berterusan.





Syarikat dan portfolio projeknya: jutaan pelanggan; jualan bernilai berbilion setiap bulan.





Ailoot menggunakan pengalaman operasi ini untuk akses API kepada ciri AI dalam produk pelanggan, ejen, aplikasi dan automasi.