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

[API panelu użytkownika](https://ailoot.ai/docs/pl/) 

# Kody doładowania

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

Metody, pola żądań i odpowiedzi.

W tej sekcji są 2 metody. Otwórz metodę, aby zobaczyć warunki dostępu, pola żądania i odpowiedź.

| Metoda i ścieżka | Opis | Dostęp |
| --- | --- | --- |
| `POST /api/v1/redeem` | Realizacja kodu | Token panelu użytkownika |
| `GET /api/v1/redeem/history` | Historia realizacji | Token panelu użytkownika |

**POST /api/v1/redeem** — Realizacja kodu

Dostęp: Token panelu użytkownika

POST`/api/v1/redeem`

## Pola JSON / formularza

| Pole | Typ | Wymagane | Walidacja / opis |
| --- | --- | --- | --- |
| `code` | `string` | tak | required |

Szablon treści żądania

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

PLACEHOLDER oznacza Twoje dane wejściowe i ich typ. Zastąp wartości i pozostaw tylko potrzebne pola opcjonalne; znaczników tekstowych nie wysyła się zamiast liczb, wartości boolean, obiektów lub tablic.

Schemat żądania: `RedeemRequest`

## Odpowiedź

Odpowiedź JSON zawiera code, message i data. Zawartość data opisano w schematach poniżej.

Schematy danych odpowiedzi: `RedeemCode`. Pola i typy — na stronach „Schematy danych”.

Schemat odpowiedzi, wartości przykładowe

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

Cechy szczególne: Wszystkie dane osobowe i obiekty są ograniczone do podmiotu JWT.

Uwagi: operacja zmienia stan lub kontynuuje jednorazową autoryzację; przykład opisuje kontrakt i nie jest wykonywany.

Metoda zmienia dane. Ponowne wysłanie jest bezpieczne tylko tam, gdzie przy metodzie podano Idempotency-Key. Jeśli odpowiedź została utracona, najpierw sprawdź wynik (na przykład listę kluczy), a potem zdecyduj, czy ponowić żądanie.

**GET /api/v1/redeem/history** — Historia realizacji

Dostęp: Token panelu użytkownika

GET`/api/v1/redeem/history`

Odczyt; ID pochodzi z Twojej poprzedniej odpowiedzi

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

## Parametry zapytania

| Pole | Typ | Wymagane | Walidacja / opis |
| --- | --- | --- | --- |
| `page` | `integer` | nie | ; domyślnie: 1; positive integer |
| `page_size` | `integer` | nie | ; domyślnie: 20; positive; clamp to100 |

Treść żądania nie jest wymagana. Przekaż wskazane powyżej parametry w URL.

## Odpowiedź

Odpowiedź JSON zawiera code, message i data. Zawartość data opisano w schematach poniżej.

Schematy danych odpowiedzi: `RedeemCode`. Pola i typy — na stronach „Schematy danych”.

Schemat odpowiedzi, wartości przykładowe

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

Cechy szczególne: Wszystkie dane osobowe i obiekty są ograniczone do podmiotu JWT.

Dodatkowe pytania? Prześlij Request ID i opis — pomożemy wyjaśnić sprawę.[Napisz do wsparcia](mailto:support@ailoot.ai)

## Ailoot · Firma i jej portfel projektów





Ailoot opiera się na zgromadzonym doświadczeniu operacyjnym, szerokiej bazie klientów, stabilnej usłudze i stałej kontroli KPI.





Firma i jej portfel projektów: miliony klientów; miesięczna sprzedaż liczona w miliardach.





Ailoot wykorzystuje to doświadczenie operacyjne, zapewniając dostęp przez API do funkcji AI w produktach klientów, agentach, aplikacjach i automatyzacjach.