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

[API dasbor](https://ailoot.ai/docs/id/) 

# Kode isi ulang

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

Metode, kolom permintaan, dan respons.

Bagian ini berisi 2 metode. Buka metode untuk melihat ketentuan akses, kolom permintaan, dan respons.

| Metode dan jalur | Deskripsi | Akses |
| --- | --- | --- |
| `POST /api/v1/redeem` | Penukaran kode | Token dasbor |
| `GET /api/v1/redeem/history` | Riwayat penukaran | Token dasbor |

**POST /api/v1/redeem** — Penukaran kode

Akses: Token dasbor

POST`/api/v1/redeem`

## Kolom JSON / formulir

| Kolom | Jenis | Wajib | Validasi / deskripsi |
| --- | --- | --- | --- |
| `code` | `string` | ya | required |

Templat isi permintaan

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

PLACEHOLDER mewakili input Anda dan tipenya. Ganti nilai-nilainya dan sisakan hanya kolom opsional yang diperlukan; jangan kirim penanda string sebagai pengganti angka, boolean, objek, atau array.

Skema permintaan: `RedeemRequest`

## Respons

Respons JSON berisi code, message, dan data. Isi data dijelaskan dalam skema di bawah.

Skema data respons: `RedeemCode`. Kolom dan tipe dijelaskan di halaman “Skema data”.

Skema respons, nilai hanya 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)"
  }
}
```

Catatan khusus: Semua data pribadi dan objek dibatasi pada subjek JWT.

Catatan khusus: Operasi mengubah keadaan atau melanjutkan autentikasi sekali pakai; contoh menjelaskan kontrak dan tidak dijalankan.

Metode ini mengubah data. Pengiriman ulang hanya aman jika metode menyatakan dukungan Idempotency-Key. Jika respons hilang, periksa dahulu hasilnya (misalnya daftar kunci), lalu putuskan apakah perlu mengirim ulang permintaan.

**GET /api/v1/redeem/history** — Riwayat penukaran

Akses: Token dasbor

GET`/api/v1/redeem/history`

Pembacaan; ID diambil dari respons Anda sebelumnya

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

## Parameter query

| Kolom | Jenis | Wajib | Validasi / deskripsi |
| --- | --- | --- | --- |
| `page` | `integer` | tidak | ; default: 1; positive integer |
| `page_size` | `integer` | tidak | ; default: 20; positive; clamp to100 |

Isi permintaan tidak diperlukan. Kirim parameter di atas dalam URL.

## Respons

Respons JSON berisi code, message, dan data. Isi data dijelaskan dalam skema di bawah.

Skema data respons: `RedeemCode`. Kolom dan tipe dijelaskan di halaman “Skema data”.

Skema respons, nilai hanya 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)"
  }
}
```

Catatan khusus: Semua data pribadi dan objek dibatasi pada subjek JWT.

Masih ada pertanyaan? Kirim Request ID dan penjelasannya — kami akan membantu.[Hubungi dukungan](mailto:support@ailoot.ai)

## Ailoot · Perusahaan dan portofolio proyeknya





Ailoot bertumpu pada pengalaman operasional yang teruji, basis pelanggan yang besar, layanan yang stabil, dan pemantauan KPI berkelanjutan.





Perusahaan dan portofolio proyeknya: jutaan pelanggan; penjualan miliaran setiap bulan.





Ailoot memanfaatkan pengalaman operasional ini untuk akses API ke fitur AI dalam produk pelanggan, agen, aplikasi, dan otomatisasi.