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

[API πίνακα ελέγχου](https://ailoot.ai/docs/el/) 

# Κωδικοί ανανέωσης υπολοίπου

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

Μέθοδοι, πεδία αιτημάτων και απαντήσεις.

Η ενότητα περιλαμβάνει 2 μεθόδους. Ανοίξτε τη μέθοδο για να δείτε τους όρους πρόσβασης, τα πεδία αιτήματος και την απάντηση.

| Μέθοδος και διαδρομή | Περιγραφή | Πρόσβαση |
| --- | --- | --- |
| `POST /api/v1/redeem` | Εξαργύρωση κωδικού | Token πίνακα ελέγχου |
| `GET /api/v1/redeem/history` | Ιστορικό εξαργυρώσεων | Token πίνακα ελέγχου |

**POST /api/v1/redeem** — Εξαργύρωση κωδικού

Πρόσβαση: Token πίνακα ελέγχου

POST`/api/v1/redeem`

## Πεδία JSON / φόρμας

| Το πεδίο | Τύπος | Υποχρεωτικό | Έλεγχος / περιγραφή |
| --- | --- | --- | --- |
| `code` | `string` | ναι | required |

Πρότυπο σώματος αιτήματος

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

Το PLACEHOLDER υποδηλώνει τη δική σας είσοδο και τον τύπο της. Αντικαταστήστε τις τιμές και κρατήστε μόνο τα προαιρετικά πεδία που χρειάζονται· οι συμβολοσειρές-δείκτες δεν αποστέλλονται αντί για αριθμούς, boolean, αντικείμενα ή πίνακες.

Σχήμα αιτήματος: `RedeemRequest`

## Απάντηση

Η απάντηση JSON περιέχει code, message και data. Το περιεχόμενο του data περιγράφεται στα σχήματα παρακάτω.

Σχήματα δεδομένων απάντησης: `RedeemCode`. Τα πεδία και οι τύποι βρίσκονται στις σελίδες «Σχήματα δεδομένων».

Σχήμα απάντησης, ενδεικτικές τιμές

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

Ιδιαιτερότητες: Όλα τα προσωπικά δεδομένα και αντικείμενα περιορίζονται στο υποκείμενο του JWT.

Ιδιαιτερότητες: Η λειτουργία αλλάζει την κατάσταση ή συνεχίζει διαδικασία εξουσιοδότησης μίας χρήσης· το παράδειγμα περιγράφει τη σύμβαση και δεν εκτελείται.

Η μέθοδος αλλάζει δεδομένα. Η επανάληψη της αποστολής είναι ασφαλής μόνο όταν στη μέθοδο αναφέρεται Idempotency-Key. Αν χαθεί η απάντηση, ελέγξτε πρώτα το αποτέλεσμα (για παράδειγμα, τη λίστα κλειδιών) και έπειτα αποφασίστε αν θα επαναλάβετε το αίτημα.

**GET /api/v1/redeem/history** — Ιστορικό εξαργυρώσεων

Πρόσβαση: Token πίνακα ελέγχου

GET`/api/v1/redeem/history`

Ανάγνωση· το ID προέρχεται από την προηγούμενη απάντησή σας

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

## Παράμετροι ερωτήματος

| Το πεδίο | Τύπος | Υποχρεωτικό | Έλεγχος / περιγραφή |
| --- | --- | --- | --- |
| `page` | `integer` | όχι | ; από προεπιλογή: 1; θετικός ακέραιος |
| `page_size` | `integer` | όχι | ; από προεπιλογή: 20; θετικό· ανώτατο όριο 100 |

Δεν απαιτείται σώμα αιτήματος. Στείλτε τις παραπάνω παραμέτρους στο URL.

## Απάντηση

Η απάντηση JSON περιέχει code, message και data. Το περιεχόμενο του data περιγράφεται στα σχήματα παρακάτω.

Σχήματα δεδομένων απάντησης: `RedeemCode`. Τα πεδία και οι τύποι βρίσκονται στις σελίδες «Σχήματα δεδομένων».

Σχήμα απάντησης, ενδεικτικές τιμές

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

Ιδιαιτερότητες: Όλα τα προσωπικά δεδομένα και αντικείμενα περιορίζονται στο υποκείμενο του JWT.

Έχετε ερωτήσεις; Στείλτε μας το Request ID και μια περιγραφή — θα σας βοηθήσουμε να βρείτε την αιτία.[Επικοινωνία με την υποστήριξη](mailto:support@ailoot.ai)

## Ailoot · Η εταιρεία και το χαρτοφυλάκιο έργων της





Η Ailoot στηρίζεται στη συσσωρευμένη λειτουργική εμπειρία, τη μεγάλη πελατειακή βάση, τη σταθερή εξυπηρέτηση και τον συνεχή έλεγχο KPI.





Η εταιρεία και το χαρτοφυλάκιο έργων της: εκατομμύρια πελάτες· μηνιαίες πωλήσεις δισεκατομμυρίων.





Η Ailoot αξιοποιεί αυτή τη λειτουργική εμπειρία για πρόσβαση μέσω API σε λειτουργίες AI στα προϊόντα, τους πράκτορες, τις εφαρμογές και τους αυτοματισμούς των πελατών.