Visión General de la API

Arquitectura

La API de TheRPC sigue la especificación JSON-RPC 2.0 y proporciona:

• Endpoints estándar HTTP y WebSocket
• Autenticación mediante claves API
• Formatos de respuesta unificados
• Compatibilidad entre redes

Protocolos de Comunicación

Endpoints HTTP

Ideal para solicitudes individuales e integraciones simples. Vea ejemplos en nuestra guía HTTP/Curl.

https://YOUR_API_ENDPOINT

Endpoints WebSocket

Ideal para suscripciones y datos en tiempo real. Vea eth_subscribe para ejemplos de suscripción.

wss://YOUR_API_ENDPOINT

Formato JSON-RPC

Estructura de Solicitud

Todas las llamadas a la API siguen el formato JSON-RPC 2.0. Vea ejemplos completos en nuestra guía de Operaciones Básicas:

{
	"jsonrpc": "2.0",
	"method": "eth_blockNumber",
	"params": [],
	"id": 1
}

Campos requeridos:

• jsonrpc: Identificador de versión (siempre "2.0")
• method: El método RPC a llamar (vea Métodos Disponibles)
• params: Array de parámetros (puede estar vacío)
• id: Identificador de solicitud

Formato de Respuesta

Todas las respuestas siguen una estructura consistente:

{
	"jsonrpc": "2.0",
	"id": 1,
	"result": "0x..."
}

O en caso de error:

{
	"jsonrpc": "2.0",
	"id": 1,
	"error": {
		"code": -32600,
		"message": "Invalid Request"
	}
}

Autenticación

Todas las solicitudes requieren una clave API en la cabecera de Autorización. Vea nuestra guía de Autenticación para una configuración detallada:

Authorization: Bearer YOUR_API_KEY

Categorías de Métodos

Métodos Estándar

• eth_: Métodos del protocolo Ethereum (eth_blockNumber, eth_getBalance, etc.)
• net_: Métodos de estado de red (net_version)
• web3_: Métodos de utilidad Web3 (web3_clientVersion)

Métodos Avanzados

• debug_: Capacidades de depuración (debug_traceTransaction)
• trace_: Rastreo de transacciones (trace_transaction)
• txpool_: Información del pool de transacciones (txpool_status)

Manejo de Errores

Códigos de error comunes (vea FAQ para estrategias detalladas de manejo de errores):

• -32700: Error de análisis
• -32600: Solicitud inválida
• -32601: Método no encontrado
• -32602: Parámetros inválidos
• -32603: Error interno

Ejemplos de Implementación

Para ejemplos prácticos de implementación, consulte nuestras guías específicas de lenguaje:

• Guía de JavaScript/TypeScript
• Guía de Python
• Ejemplos HTTP/Curl
• Vea todos los SDKs disponibles en nuestra sección Herramientas y SDKs

Límites de Tasa

Para información sobre límites de solicitudes y cuotas, vea nuestra documentación de Límites de Tasa.

Ver También

• Guía de Autenticación - Información Detallada de Autenticación
• Métodos Disponibles - Lista Completa de Métodos
• Operaciones Básicas - Patrones de Uso Comunes
• FAQ - Preguntas y Respuestas Comunes