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

[API del panel de control](https://ailoot.ai/docs/es/) 

# Códigos de recarga

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

Métodos, campos de las solicitudes y respuestas.

Esta sección contiene 2 métodos. Abre un método para consultar las condiciones de acceso, los campos de la solicitud y la respuesta.

| Método y ruta | Descripción | Acceso |
| --- | --- | --- |
| `POST /api/v1/redeem` | Canjear un código | Token del panel de control |
| `GET /api/v1/redeem/history` | Historial de canjes | Token del panel de control |

**POST /api/v1/redeem** — Canjear un código

Acceso: token del panel de control

POST`/api/v1/redeem`

## Campos JSON / formulario

| El campo | Tipo | Obligatorio | Validación / descripción |
| --- | --- | --- | --- |
| `code` | `string` | sí | required |

Plantilla del cuerpo de la solicitud

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

PLACEHOLDER representa tu entrada y su tipo. Sustituye los valores y conserva solo los campos opcionales que necesites; los marcadores de cadena no se envían en lugar de números, boolean, objetos o arrays.

Esquema de la solicitud: `RedeemRequest`

## Respuesta

La respuesta JSON contiene code, message y data. El contenido de data se describe en los esquemas siguientes.

Esquemas de datos de la respuesta: `RedeemCode`. Los campos y los tipos se describen en las páginas «Esquemas de datos».

Esquema de respuesta con valores ilustrativos

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

Notas: todos los datos personales y los objetos quedan limitados al sujeto del JWT.

Notas: la operación cambia el estado o continúa una autorización de un solo uso; el ejemplo describe el contrato y no se ejecuta.

El método modifica datos. Repetir la solicitud solo es seguro si el método indica Idempotency-Key. Si se pierde la respuesta, comprueba primero el resultado (por ejemplo, la lista de claves) y después decide si repetir la solicitud.

**GET /api/v1/redeem/history** — Historial de canjes

Acceso: token del panel de control

GET`/api/v1/redeem/history`

Lectura; el ID se obtiene de tu respuesta anterior

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

## Parámetros de consulta

| El campo | Tipo | Obligatorio | Validación / descripción |
| --- | --- | --- | --- |
| `page` | `integer` | no | ; valor predeterminado: 1; entero positivo |
| `page_size` | `integer` | no | ; valor predeterminado: 20; valor positivo; se limita automáticamente a 100 |

No se necesita cuerpo de solicitud. Envía los parámetros anteriores en la URL.

## Respuesta

La respuesta JSON contiene code, message y data. El contenido de data se describe en los esquemas siguientes.

Esquemas de datos de la respuesta: `RedeemCode`. Los campos y los tipos se describen en las páginas «Esquemas de datos».

Esquema de respuesta con valores ilustrativos

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

Notas: todos los datos personales y los objetos quedan limitados al sujeto del JWT.

¿Tienes alguna pregunta? Envíanos el Request ID y una descripción; te ayudaremos a resolverla.[Contactar con soporte](mailto:support@ailoot.ai)

## Ailoot · La empresa y su cartera de proyectos





Ailoot se apoya en la experiencia operativa acumulada, una amplia base de clientes, un servicio estable y el seguimiento continuo de KPI.





La empresa y su cartera de proyectos: millones de clientes; ventas por miles de millones al mes.





Ailoot aplica esa experiencia operativa al acceso por API a funciones de IA en productos de clientes, agentes, aplicaciones y automatizaciones.