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

[Fiók-API](https://ailoot.ai/docs/hu/) 

# Feltöltőkódok

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

Metódusok, kérésmezők és válaszok.

Ebben a részben 2 metódus található. Nyissa meg a metódust a hozzáférési feltételek, a kérésmezők és a válasz megtekintéséhez.

| Metódus és útvonal | Leírás | Hozzáférés |
| --- | --- | --- |
| `POST /api/v1/redeem` | Kód beváltása | Fióktoken |
| `GET /api/v1/redeem/history` | Beváltási előzmények | Fióktoken |

**POST /api/v1/redeem** — Kód beváltása

Hozzáférés: fióktoken

POST`/api/v1/redeem`

## JSON- / űrlapmezők

| Mező: | Típus | Kötelező | Ellenőrzés / leírás |
| --- | --- | --- | --- |
| `code` | `string` | igen | required |

Kéréstörzs-sablon

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

A PLACEHOLDER az Ön által megadandó értéket és annak típusát jelöli. Cserélje ki az értékeket, és csak a szükséges nem kötelező mezőket tartsa meg; karakterlánc-jelölők nem küldhetők számok, boolean értékek, objektumok vagy tömbök helyett.

A kérés sémája: `RedeemRequest`

## Válasz

A JSON-válasz code, message és data mezőt tartalmaz. A data tartalmát az alábbi sémák írják le.

A válasz adatsémái: `RedeemCode`. A mezők és típusok az „Adatsémák” oldalain találhatók.

Válaszséma, szemléltető értékekkel

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

Sajátosságok: minden személyes adat és objektum a JWT alanyához kötött.

Sajátosságok: a művelet állapotot módosít vagy egyszeri hitelesítést folytat; a példa a szerződést írja le, és nem kerül végrehajtásra.

A metódus adatokat módosít. Az újraküldés csak ott biztonságos, ahol a metódusnál szerepel az Idempotency-Key. Ha a válasz elveszett, előbb ellenőrizze az eredményt (például a kulcsok listáját), és csak utána döntsön az újbóli elküldésről.

**GET /api/v1/redeem/history** — Beváltási előzmények

Hozzáférés: fióktoken

GET`/api/v1/redeem/history`

Olvasás; az azonosító a korábbi válaszából származik

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

## Query-paraméterek

| Mező: | Típus | Kötelező | Ellenőrzés / leírás |
| --- | --- | --- | --- |
| `page` | `integer` | nem | ; alapértelmezés: 1; positive integer |
| `page_size` | `integer` | nem | ; alapértelmezés: 20; positive; clamp to100 |

A kéréshez nem szükséges törzs. A fent felsorolt paramétereket az URL-ben adja meg.

## Válasz

A JSON-válasz code, message és data mezőt tartalmaz. A data tartalmát az alábbi sémák írják le.

A válasz adatsémái: `RedeemCode`. A mezők és típusok az „Adatsémák” oldalain találhatók.

Válaszséma, szemléltető értékekkel

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

Sajátosságok: minden személyes adat és objektum a JWT alanyához kötött.

Maradt kérdése? Küldje el a Request ID-t és a probléma leírását — segítünk tisztázni.[Írjon a támogatásnak](mailto:support@ailoot.ai)

## Ailoot · A vállalat és projektportfóliója





Az Ailoot felhalmozott működési tapasztalatra, széles ügyfélkörre, stabil szolgáltatásra és folyamatos KPI-ellenőrzésre épít.





A vállalat és projektportfóliója: ügyfelek milliói; havi értékesítés milliárdos nagyságrendben.





Az Ailoot ezt a működési tapasztalatot használja az ügyfelek termékeiben, ágenseiben, alkalmazásaiban és automatizálásaiban elérhető AI-funkciók API-hozzáféréséhez.