Un trabajo de scraping puede fallar por muchas razones. La página objetivo puede bloquear la solicitud. Las opciones de solicitud pueden ser incorrectas. La cuenta puede no tener créditos. La conexión al servicio también puede no estar disponible por un corto tiempo. Un simple chequeo de estado te ayuda a separar estos casos.
La URL de la API de estado de ScraperFly es un chequeo de salud ligero. Tu sistema puede llamarla en un horario, almacenar el resultado y construir un pequeño historial de disponibilidad del servicio y tiempo de respuesta.
Esta página explica una forma simple de usar el chequeo de estado. El objetivo no es reemplazar los registros de solicitudes. El objetivo es añadir una señal clara: ¿puede tu sistema alcanzar ScraperFly en este momento, y qué tan rápido responde el chequeo?
Para qué sirve la URL de la API de estado
La URL de la API de estado es un pequeño chequeo de servicio. Le dice a tu aplicación si ScraperFly puede ser alcanzado desde el lugar donde se ejecutan tus propios trabajos. Si el chequeo responde con un resultado saludable, tu aplicación sabe que la ruta básica del servicio está funcionando.
Esto no significa que cada scraping tendrá éxito. Un chequeo de servicio saludable no corrige una URL incorrecta, una página objetivo bloqueada, una clave API errónea, un saldo de crédito faltante, o una página que necesita renderizado de JavaScript. Solo responde a una simple pregunta: ¿es el servicio de ScraperFly alcanzable en este momento?
Cómo comprobar la salud del servicio cada pocos minutos
Un monitor práctico puede llamar a la URL de la API de estado cada cinco minutos. Para cada chequeo, almacena el tiempo, el resultado HTTP y el tiempo de respuesta. Esto le da a tu equipo una vista simple de la disponibilidad a lo largo del tiempo.
No alertes sobre una muestra lenta o fallida demasiado rápido. Las redes pueden tener retrasos cortos. Un mejor monitor espera a que haya fallos repetidos o un patrón claro de tiempos de respuesta lentos antes de enviar una alerta.
| Valor a almacenar | Por qué ayuda |
|---|---|
| Resultado HTTP | Muestra si el chequeo de estado respondió con éxito. |
| Tiempo de respuesta | Muestra cuánto tiempo tomó el chequeo de servicio desde tu entorno. |
| Hora del chequeo | Muestra cuándo se recogió la muestra. |
| Conteo de fallos | Ayuda a evitar alertas ruidosas de un problema de red corto. |
Ejemplo de registro de estado
Una pequeña tabla es suficiente para muchos equipos. Puedes mantener las últimas horas o días de chequeos y mostrarlas en un panel interno. La tabla a continuación es solo un ejemplo del tipo de datos que puedes almacenar.
| Hora | URL de chequeo | Resultado | Tiempo de respuesta | Nota |
|---|---|---|---|---|
| 09:00 | /api/v1/status | 200 OK | 142 ms | Chequeo de servicio aprobado. |
| 09:05 | /api/v1/status | 200 OK | 156 ms | Chequeo de servicio aprobado. |
| 09:10 | /api/v1/status | 200 OK | 149 ms | Chequeo de servicio aprobado. |
Cómo leer el estado junto con los registros de solicitudes
Usa el chequeo de estado junto con los registros de scraping normales. Si el chequeo de servicio es saludable pero un scraping falla, mira la solicitud en sí: URL objetivo, código de estado objetivo, URL final, tamaño de respuesta, formato de salida, opción de renderizado, historial de reintentos y estado de la cuenta.
Si el chequeo de servicio falla muchas veces seguidas, trata eso como una señal de conectividad del servicio. Pausa los reintentos ruidosos, mantiene los trabajos fallidos en una cola y reinténtalos después de que el chequeo de salud esté estable nuevamente.
Lo que el chequeo de estado no prueba
El chequeo de estado no es una garantía de que un sitio web objetivo devolverá datos utilizables. No prueba tu URL objetivo. No confirma que una página permita el acceso. No confirma que se necesite renderizado de JavaScript. Tampoco reemplaza los diagnósticos a nivel de cuenta, facturación o solicitud.
Piénsalo como una pequeña señal operativa. Ayuda a responder si ScraperFly es alcanzable. Después de eso, tus registros de solicitudes explican qué sucedió con cada solicitud de scraping.
FAQ
¿Con qué frecuencia debo llamar a la URL de la API de estado de ScraperFly?
Para un pequeño monitor de salud, comprobar cada cinco minutos suele ser suficiente. Puedes usar un intervalo más corto si tu propio sistema necesita alertas más rápidas.
¿Un chequeo de estado saludable significa que cada solicitud de scraping funcionará?
No. Un chequeo de estado saludable solo significa que el servicio puede ser alcanzado. Los errores de destino, opciones de solicitud incorrectas, problemas de cuenta, límites de tasa y bloqueos de acceso aún necesitan diagnósticos a nivel de solicitud.
¿Debo detener todos los trabajos de scraping después de un chequeo de estado fallido?
Generalmente no. Un chequeo fallido puede ser un problema de red corto. Es mejor esperar a que haya fallos repetidos antes de pausar trabajos o enviar una alerta.