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

[API uživatelského panelu](https://ailoot.ai/docs/cs/) 

# Kódy pro doplnění zůstatku

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

Metody, pole požadavků a odpovědi.

V této sekci jsou 2 metody. Otevřete metodu a prohlédněte si podmínky přístupu, pole požadavku a odpověď.

| Metoda a cesta | Popis | Přístup |
| --- | --- | --- |
| `POST /api/v1/redeem` | Uplatnění kódu | Token uživatelského panelu |
| `GET /api/v1/redeem/history` | Historie uplatnění | Token uživatelského panelu |

**POST /api/v1/redeem** – Uplatnění kódu

Přístup: token uživatelského panelu

POST`/api/v1/redeem`

## Pole JSON / formuláře

| Pole | Typ | Povinné | Kontrola / popis |
| --- | --- | --- | --- |
| `code` | `string` | ano | required |

Šablona těla požadavku

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

PLACEHOLDER označuje váš vstup a jeho typ. Nahraďte hodnoty a ponechte pouze potřebná nepovinná pole; řetězcové zástupné značky se neodesílají místo čísel, hodnot typu boolean, objektů nebo polí.

Schéma požadavku: `RedeemRequest`

## Odpověď

Odpověď JSON obsahuje code, message a data. Obsah data je popsán ve schématech níže.

Datová schémata odpovědi: `RedeemCode`. Pole a typy najdete na stránkách „Datová schémata“.

Schéma odpovědi, hodnoty jsou ilustrativní

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

Specifika: všechny osobní údaje a objekty jsou omezeny na subjekt JWT.

Specifika: operace mění stav nebo pokračuje v jednorázové autorizaci; příklad popisuje kontrakt a neprovádí se.

Metoda mění data. Opakované odeslání je bezpečné pouze tam, kde je u metody uveden Idempotency-Key. Pokud se odpověď ztratila, nejprve ověřte výsledek (například seznam klíčů) a teprve potom rozhodněte, zda požadavek zopakovat.

**GET /api/v1/redeem/history** – Historie uplatnění

Přístup: token uživatelského panelu

GET`/api/v1/redeem/history`

Čtení; ID pochází z vaší předchozí odpovědi

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

## Parametry dotazu (query)

| Pole | Typ | Povinné | Kontrola / popis |
| --- | --- | --- | --- |
| `page` | `integer` | ne | ; výchozí hodnota: 1; kladné celé číslo |
| `page_size` | `integer` | ne | ; výchozí hodnota: 20; kladné číslo; hodnoty nad 100 se sníží na 100 |

Tělo požadavku není potřeba. Výše uvedené parametry předávejte v URL.

## Odpověď

Odpověď JSON obsahuje code, message a data. Obsah data je popsán ve schématech níže.

Datová schémata odpovědi: `RedeemCode`. Pole a typy najdete na stránkách „Datová schémata“.

Schéma odpovědi, hodnoty jsou ilustrativní

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

Specifika: všechny osobní údaje a objekty jsou omezeny na subjekt JWT.

Máte další dotazy? Pošlete Request ID a popis – pomůžeme situaci objasnit.[Napsat podpoře](mailto:support@ailoot.ai)

## Ailoot · Společnost a její portfolio projektů





Ailoot staví na dlouhodobých provozních zkušenostech, široké klientské základně, stabilních službách a průběžném sledování KPI.





Společnost a její portfolio projektů: miliony zákazníků; měsíční tržby v miliardách.





Ailoot využívá tyto provozní zkušenosti k poskytování přístupu přes API k funkcím AI v produktech zákazníků, agentech, aplikacích a automatizacích.