> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentwallex.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Descripción general de la referencia de API

> URLs base, autenticación, paginación y contrato de errores para la API REST de AgentWallex.

## URLs base

```
Sandbox:    https://api-sandbox.agentwallex.com/api/v1
Production: https://api.agentwallex.com/api/v1
```

<Note>
  Use la URL de sandbox para desarrollo y pruebas. Cambie a producción solo cuando esté listo para transaccionar con fondos reales.
</Note>

## Autenticación

Todas las solicitudes de API deben incluir uno de los siguientes encabezados de autenticación:

| Método     | Encabezado      | Ejemplo                               |
| ---------- | --------------- | ------------------------------------- |
| Clave API  | `X-API-Key`     | `X-API-Key: awx_your_api_key`         |
| JWT Bearer | `Authorization` | `Authorization: Bearer eyJhbGciOi...` |

```bash theme={null}
# API key authentication
curl -X GET https://api.agentwallex.com/api/v1/agents \
  -H "X-API-Key: awx_your_api_key"

# JWT authentication
curl -X GET https://api.agentwallex.com/api/v1/agents \
  -H "Authorization: Bearer eyJhbGciOi..."
```

Consulte [Autenticación](/es/introduction/authentication) para detalles completos sobre cómo obtener y gestionar credenciales.

## Paginación

Todos los endpoints de listado soportan paginación con los siguientes parámetros de consulta:

| Parámetro   | Predeterminado | Máximo | Descripción                         |
| ----------- | -------------- | ------ | ----------------------------------- |
| `page_num`  | 1              | --     | Número de página (indexado desde 1) |
| `page_size` | 20             | 100    | Número de elementos por página      |

Formato de respuesta:

```json theme={null}
{
  "data": [],
  "total": 42,
  "has_more": true
}
```

## Contrato de errores

Todos los errores siguen un formato consistente:

```json theme={null}
{
  "code": "invalid_request",
  "type": "invalid_request_error",
  "message": "human readable error description"
}
```

### Tipos de errores

| Tipo                    | Estado HTTP | Descripción                                |
| ----------------------- | ----------- | ------------------------------------------ |
| `invalid_request_error` | 400         | Cuerpo de solicitud o parámetros inválidos |
| `authentication_error`  | 401         | Credenciales faltantes o inválidas         |
| `authorization_error`   | 403         | Permisos insuficientes                     |
| `not_found_error`       | 404         | El recurso no existe                       |
| `rate_limit_error`      | 429         | Límite de tasa excedido                    |
| `internal_error`        | 500         | Error del lado del servidor                |

Consulte [Manejo de errores](/es/guides/error-handling) para orientación detallada sobre el manejo de errores.

## Secciones de la API

<CardGroup cols={2}>
  <Card title="Agentes" icon="robot" href="/es/api-reference/agents-create">
    Cree y gestione billeteras de agentes de IA.
  </Card>

  <Card title="Transacciones" icon="arrow-right-arrow-left" href="/es/api-reference/transactions-create">
    Envíe pagos y consulte el historial de transacciones.
  </Card>

  <Card title="Políticas" icon="shield-check" href="/es/api-reference/policies">
    Configure límites de gasto y controles de acceso.
  </Card>

  <Card title="Webhooks" icon="bell" href="/es/api-reference/webhooks">
    Registre y gestione endpoints de webhooks.
  </Card>

  <Card title="x402 Pay" icon="credit-card" href="/es/api-reference/x402-pay">
    Active la negociación de micropagos x402.
  </Card>

  <Card title="Sesiones x402" icon="clock" href="/es/api-reference/x402-sessions">
    Gestione presupuestos de sesión x402.
  </Card>
</CardGroup>