Saltar al contenido principal

URLs base

Sandbox:    https://api-sandbox.agentwallex.com/api/v1
Production: https://api.agentwallex.com/api/v1
Use la URL de sandbox para desarrollo y pruebas. Cambie a producción solo cuando esté listo para transaccionar con fondos reales.

Autenticación

Todas las solicitudes de API deben incluir uno de los siguientes encabezados de autenticación:
MétodoEncabezadoEjemplo
Clave APIX-API-KeyX-API-Key: awx_your_api_key
JWT BearerAuthorizationAuthorization: Bearer eyJhbGciOi...
# 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 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ámetroPredeterminadoMáximoDescripción
page_num1Número de página (indexado desde 1)
page_size20100Número de elementos por página
Formato de respuesta:
{
  "data": [],
  "total": 42,
  "has_more": true
}

Contrato de errores

Todos los errores siguen un formato consistente:
{
  "code": "invalid_request",
  "type": "invalid_request_error",
  "message": "human readable error description"
}

Tipos de errores

TipoEstado HTTPDescripción
invalid_request_error400Cuerpo de solicitud o parámetros inválidos
authentication_error401Credenciales faltantes o inválidas
authorization_error403Permisos insuficientes
not_found_error404El recurso no existe
rate_limit_error429Límite de tasa excedido
internal_error500Error del lado del servidor
Consulte Manejo de errores para orientación detallada sobre el manejo de errores.

Secciones de la API

Agentes

Cree y gestione billeteras de agentes de IA.

Transacciones

Envíe pagos y consulte el historial de transacciones.

Políticas

Configure límites de gasto y controles de acceso.

Webhooks

Registre y gestione endpoints de webhooks.

x402 Pay

Active la negociación de micropagos x402.

Sesiones x402

Gestione presupuestos de sesión x402.