Quicknode proporciona registros de errores para tus puntos finales RPC. Identifica y resuelve fácilmente los problemas consultando información detallada sobre los errores directamente desde tu panel de control.

Códigos de error HTTP

Veamos cuáles son los códigos de error HTTP más habituales con los que te puedes encontrar, qué significan y qué puedes hacer para evitarlos.

400Solicitud incorrecta

Tipo de solicitud HTTP incorrecto (por ejemplo, se ha utilizado GET en lugar de POST) o caracteres no válidos

401No autorizado

Esto puede ocurrir cuando no se cumplen uno o varios requisitos de seguridad, como una autenticación mediante token incorrecta, una dirección IP que no figura en la lista blanca, un JWT no válido, etc.

403Prohibido

Terminal desactivado (una de las razones podría ser un pago atrasado)

403Prohibido: no se ha encontrado el seguimiento personalizado

El código de seguimiento personalizado no figura en la lista blanca (envía una solicitud para iniciar el proceso de aprobación)

404No encontrado

URL incorrecta o método incorrecto

413Contenido demasiado grande

El cuerpo de la solicitud es demasiado grande

413Entidad de solicitud demasiado grande

Las funciones `eth_getLogs` y `eth_newFilter` están limitadas a un rango de 10 000 bloques. Aplicamos un límite de 10 000 bloques al solicitar registros y eventos.

429Demasiadas solicitudes

El número de solicitudes por segundo (RPS) supera el límite permitido por tu plan. Obtén más información sobre los errores 429 en nuestra documentación de soporte técnico.

500Error interno del servidor

Envía una solicitud para que el equipo de asistencia revise los errores lo antes posible.

503Servicio no disponible

Envía una solicitud para que el equipo de asistencia revise los errores lo antes posible.

Ejemplo de código de error HTTP

El fragmento de código que aparece a continuación es un ejemplo del código de error 429.

{
	"jsonrpc": "2.0",
	"error": {
		"code": 429,
		"message": "The requests per second (RPS) of your requests are higher than your plan allows."
	},
	"id": 1
}

Registros de los terminales

Quicknode proporciona registros de tus puntos finales RPC para ayudarte a diagnosticar problemas. Puedes consultar los registros directamente en tu panel de control de Quicknode accediendo a:

1. Elementos de la barra lateral
2. Seleccionar tu dispositivo
3. Abrir la pestaña «Registros »

Puedes filtrar los registros por intervalo de tiempo, tipo de respuesta, método y red.

Qué datos se registran

Solicitudes al punto final
: solicitudes realizadas a tu punto final, incluyendo el estado HTTP, el método de solicitud, el método o la ruta RPC y la marca de tiempo.

Detalles del error
Cuando están disponibles, las solicitudes fallidas incluyen detalles del error, como códigos de error RPC, el contenido de las solicitudes y las respuestas, y enlaces a documentación relacionada.

Restricciones en la tala

La disponibilidad de los registros puede variar en función del método, el tipo de respuesta, la red y el plan. Para mantener un rendimiento óptimo de los terminales, el registro de datos funciona según el principio de «mejor esfuerzo». Es posible que algunos registros se descarten durante los periodos de mucho tráfico para mantener una baja latencia.

Conservación y acceso

Los planes «Build» y «Scale» incluyen acceso al panel de control con retención estándar de registros. Los planes «Enterprise» ofrecen períodos de retención ampliados y acceso programático mediante API para la recuperación de registros.

Si te aparecen otros códigos de error, háznoslo saber enviando un ticket. Estaremos encantados de ayudarte.