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

[Boshqaruv paneli API](https://ailoot.ai/docs/uz/) 

# Balans to‘ldirish kodlari

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

Metodlar, so‘rov maydonlari va javoblar.

Bo‘limda 2 ta metod bor. Kirish shartlari, so‘rov maydonlari va javobni ko‘rish uchun metodni oching.

| Metod va yo‘l | Tavsif | Kirish huquqi |
| --- | --- | --- |
| `POST /api/v1/redeem` | Kodni ishlatish | Boshqaruv paneli tokeni |
| `GET /api/v1/redeem/history` | Kodlarni ishlatish tarixi | Boshqaruv paneli tokeni |

**POST /api/v1/redeem** — Kodni ishlatish

Kirish: Boshqaruv paneli tokeni

POST`/api/v1/redeem`

## JSON / forma maydonlari

| Maydon: | Tur | Majburiy | Tekshiruv / tavsif |
| --- | --- | --- | --- |
| `code` | `string` | ha | required |

So‘rov tanasi shabloni

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

PLACEHOLDER siz kiritadigan qiymat va uning turini bildiradi. Qiymatlarni almashtiring va faqat kerakli ixtiyoriy maydonlarni qoldiring; sonlar, boolean, obyektlar yoki massivlar o‘rniga matnli belgilar yuborilmaydi.

So‘rov sxemasi: `RedeemRequest`

## Javob

JSON javobi code, message va data maydonlarini o‘z ichiga oladi. data mazmuni quyidagi sxemalarda tasvirlangan.

Javob ma’lumotlari sxemalari: `RedeemCode`. Maydonlar va turlar “Ma’lumotlar sxemalari” sahifalarida.

Javob sxemasi, qiymatlar shartli

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

Xususiyatlar: Barcha shaxsiy ma’lumotlar va obyektlar JWT subyekti bilan cheklangan.

Xususiyatlar: operatsiya holatni o‘zgartiradi yoki bir martalik avtorizatsiyani davom ettiradi; misol API interfeysining shartlarini tavsiflaydi va bajarilmaydi.

Metod ma’lumotlarni o‘zgartiradi. Qayta yuborish faqat metod uchun Idempotency-Key ko‘rsatilgan hollarda xavfsiz. Javob yo‘qolgan bo‘lsa, avval natijani tekshiring (masalan, kalitlar ro‘yxatini), so‘ng so‘rovni takrorlash yoki takrorlamaslikni hal qiling.

**GET /api/v1/redeem/history** — Kodlarni ishlatish tarixi

Kirish: Boshqaruv paneli tokeni

GET`/api/v1/redeem/history`

O‘qish; ID oldingi javobingizdan olinadi

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

## Query parametrlari

| Maydon: | Tur | Majburiy | Tekshiruv / tavsif |
| --- | --- | --- | --- |
| `page` | `integer` | yo‘q | ; standart qiymat: 1; positive integer |
| `page_size` | `integer` | yo‘q | ; standart qiymat: 20; positive; clamp to100 |

So‘rov tanasi talab qilinmaydi. Yuqoridagi parametrlarni URL orqali uzating.

## Javob

JSON javobi code, message va data maydonlarini o‘z ichiga oladi. data mazmuni quyidagi sxemalarda tasvirlangan.

Javob ma’lumotlari sxemalari: `RedeemCode`. Maydonlar va turlar “Ma’lumotlar sxemalari” sahifalarida.

Javob sxemasi, qiymatlar shartli

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

Xususiyatlar: Barcha shaxsiy ma’lumotlar va obyektlar JWT subyekti bilan cheklangan.

Savollaringiz qoldimi? Request ID va tavsifni yuboring — tushunishga yordam beramiz.[Yordam xizmatiga yozish](mailto:support@ailoot.ai)

## Ailoot · Kompaniya va uning loyihalar portfeli





Ailoot to‘plangan faoliyat tajribasi, keng mijozlar bazasi, barqaror xizmat va doimiy KPI nazoratiga tayanadi.





Kompaniya va uning loyihalar portfeli: millionlab mijozlar; oylik sotuvlar hajmi milliardlarda.





Ailoot bu faoliyat tajribasini mijozlar mahsulotlari, agentlar, ilovalar va avtomatlashtirishlarda AI imkoniyatlariga API orqali kirishni ta’minlashda qo‘llaydi.