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

[API dell’area personale](https://ailoot.ai/docs/it/) 

# Codici di ricarica

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

Metodi, campi delle richieste e risposte.

La sezione contiene 2 metodi. Apri un metodo per vedere condizioni di accesso, campi della richiesta e risposta.

| Metodo e percorso | Descrizione | Accesso |
| --- | --- | --- |
| `POST /api/v1/redeem` | Riscatto del codice | Token dell’area personale |
| `GET /api/v1/redeem/history` | Cronologia dei riscatti | Token dell’area personale |

**POST /api/v1/redeem** — Riscatto del codice

Accesso: token dell’area personale

POST`/api/v1/redeem`

## Campi JSON / modulo

| Il campo | Tipo | Obbligatorio | Verifica / descrizione |
| --- | --- | --- | --- |
| `code` | `string` | sì | required |

Modello del corpo della richiesta

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

PLACEHOLDER indica il tuo input e il suo tipo. Sostituisci i valori e mantieni solo i campi facoltativi necessari; i segnaposto stringa non vanno inviati al posto di numeri, boolean, oggetti o array.

Schema della richiesta: `RedeemRequest`

## Risposta

La risposta JSON contiene code, message e data. Il contenuto di data è descritto negli schemi sotto.

Schemi dei dati della risposta: `RedeemCode`. Campi e tipi sono nelle pagine «Schemi dei dati».

Schema della risposta, valori illustrativi

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

Particolarità: Tutti i dati personali e gli oggetti sono limitati al soggetto JWT.

Particolarità: L’operazione modifica lo stato o prosegue un’autorizzazione monouso; l’esempio descrive il contratto e non viene eseguito.

Il metodo modifica i dati. Ripetere l’invio è sicuro solo quando il metodo indica Idempotency-Key. Se la risposta va persa, controlla prima il risultato (ad esempio l’elenco delle chiavi), poi decidi se ripetere la richiesta.

**GET /api/v1/redeem/history** — Cronologia dei riscatti

Accesso: token dell’area personale

GET`/api/v1/redeem/history`

Lettura; l’ID si ricava dalla risposta precedente che hai ricevuto

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

## Parametri query

| Il campo | Tipo | Obbligatorio | Verifica / descrizione |
| --- | --- | --- | --- |
| `page` | `integer` | no | ; predefinito: 1; intero positivo |
| `page_size` | `integer` | no | ; predefinito: 20; positivo; limitato a 100 |

Il corpo della richiesta non è necessario. Passa i parametri indicati sopra nell’URL.

## Risposta

La risposta JSON contiene code, message e data. Il contenuto di data è descritto negli schemi sotto.

Schemi dei dati della risposta: `RedeemCode`. Campi e tipi sono nelle pagine «Schemi dei dati».

Schema della risposta, valori illustrativi

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

Particolarità: Tutti i dati personali e gli oggetti sono limitati al soggetto JWT.

Hai altre domande? Invia il Request ID e una descrizione — ti aiuteremo a chiarire il problema.[Contatta l’assistenza](mailto:support@ailoot.ai)

## Ailoot · L’azienda e il suo portafoglio di progetti





Ailoot si basa su un’esperienza operativa consolidata, un’ampia base di clienti, un servizio stabile e un controllo costante dei KPI.





L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese.





Ailoot mette questa esperienza operativa al servizio dell’accesso API alle funzioni AI nei prodotti dei clienti, negli agenti, nelle applicazioni e nelle automazioni.