Respuesta rápida
¿Cómo sé si WebReaderAPI funciona?
Llama a GET https://webreaderapi.com/api/v1/credits con tu clave: es gratis, y una respuesta normal significa que la API y tu clave funcionan. Si una página falla, el código de error te dice por qué, y WebReaderAPI no cobra nada por ello. Los incidentes de nuestro lado quedan registrados en el changelog con su fecha.
¿Cuál es la comprobación de estado más rápida?
El endpoint de créditos. Responde sin obtener ningún sitio web, así que solo prueba nuestro lado: la autenticación, la API y tu cuenta.
curl -s https://webreaderapi.com/api/v1/credits -H "Authorization: Bearer $WEBREADER_API_KEY"
¿Qué errores vienen del sitio web y cuáles de nosotros?
El código de error indica dónde está el problema. Ninguno de estos errores usa un crédito.
| Código | Dónde está el problema | Qué hacer |
|---|---|---|
blocked_by_robots | El robots.txt del sitio rechaza nuestro rastreador | Nada: el sitio ha dicho que no |
blocked_by_site_policy | El sitio declara ai-input=no | Nada: el sitio ha dicho que no |
target_refused | El sitio respondió 403, 429, un challenge o un login | Inténtalo más tarde, o pide acceso al sitio |
fetch_failed | DNS, TLS, conexión o una página 404/410 | Comprueba la URL; reinténtalo más tarde |
fetch_timeout | El sitio no respondió a tiempo | Reinténtalo con un timeout mayor |
concurrency_limit | Demasiadas solicitudes a la vez desde tu cuenta | Baja el ritmo o pide un límite mayor |
invalid_api_key, insufficient_credits | Tu clave o tu saldo | Comprueba el panel |
La página de errores detalla cada caso, con un bucle de reintento.
¿Por qué no hay aquí una cifra de uptime en vivo?
Porque todavía no hemos medido ninguna sobre una muestra pública, y una cifra inventada te engañaría. El éxito de una lectura depende sobre todo del sitio que se lee, así que un único porcentaje diría poco. Cuando publiquemos cifras, vendrán con el método, la muestra y la fecha.
¿Dónde se anuncian los incidentes?
En el changelog, con la fecha, los endpoints afectados y lo que se hizo. Si ves errores repetidos por nuestro lado (códigos distintos de los causados por el sitio de destino), escribe a [email protected] con la hora de la solicitud y el código de error.
Estado: preguntas frecuentes
¿Comprobar mis créditos cuesta algo?
No. GET https://webreaderapi.com/api/v1/credits nunca usa un crédito, así que puedes llamarlo desde una comprobación de estado tantas veces como quieras, dentro de tu límite de concurrencia.
Una página me falla pero se abre en mi navegador. ¿Por qué?
Normalmente porque el sitio trata a los robots de forma distinta que a las personas: puede rechazar nuestro rastreador en robots.txt o responder a las solicitudes automatizadas con una página de challenge. Devolvemos su respuesta y no cobramos nada. El código de error y target_status muestran lo que envió el sitio.
¿Se cobran alguna vez las lecturas fallidas?
No. 1 crédito = 1 página leída sin navegador; 2 créditos cuando la página necesita un navegador para renderizar JavaScript. Una solicitud que falla, o que el robots.txt de un sitio rechaza, no se cobra.