Entrada: errores
Llamadas de verificación del puntaje del dominio que fallan: 401, 402 y filas vacías
Entrada: errores. Dos códigos HTTP tienen significado, una bandera indica si la llamada se completó y una propiedad de datos explica la mayoría de las sorpresas.
Síntoma, causa, solución
| Síntoma | Causa probable | Solución |
|---|---|---|
| HTTP 401 | Clave faltante, mal escrita o revocada | Envía key=sk_... o el encabezado Bearer; copia la clave nuevamente desde la página de la cuenta |
| HTTP 402 | Se han agotado los créditos | Recarga en USDT (TRC-20); las acciones gratuitas siguen funcionando |
| ok es falso | La llamada no se completó | Lee primero el estado HTTP y luego el cuerpo de la respuesta |
| El dominio parece sin puntuar | Pocos o ningún enlace en el índice | Consulta los dominios de referencia; un DR de 0 significa que no se encontraron |
| Falta un enlace reciente | Las actualizaciones del índice ocurren aproximadamente una vez al mes | Espera la próxima actualización; no reintentes en bucle |
| Las páginas se detienen después de 50.000 filas | Límite de paginación | Reduce con una consulta o ordenación y luego pagina nuevamente |
| Llamada masiva rechazada | Más de 2.000 dominios | Divide la lista en fragmentos |
Los pagos son en USDT en la red TRC-20. El inicio de sesión es solo con Google. Las listas masivas tienen un límite de 2.000 dominios, las llamadas de listado de 1.000 filas y la paginación profunda de 50.000 filas.
Orden del diagnóstico
Comienza con el código de estado. Un 401 se refiere a la identidad y un 402 al dinero. Se solucionan en lugares diferentes.
Luego lee ok. Cada respuesta lo incluye. En las llamadas autenticadas, _credits muestra el costo y el saldo restante, por lo que un saldo agotado es visible antes de que llegue el 402.
Mantén este orden fijo en tu manual de ejecución. Cualquier persona que salte directamente a los datos puede pasar una mañana resolviendo un problema que el código de estado habría identificado de inmediato.
Solo después de eso deberías sospechar de los datos. Un sitio nuevo a menudo muestra un DR bajo. La causa rara vez es un error. La razón más probable es una instantánea mensual que es anterior a sus enlaces. Compara la cifra con la entrada de la fórmula.
Separar un problema de clave de un problema de saldo
Un 401 y un 402 se parecen en un script, porque ambos detienen el mismo bucle. Tienen causas diferentes, así que sepáralos antes de cambiar algo.
Comienza con una acción gratuita en el mismo dominio. Si responde y la llamada pagada no, el dominio está bien y el problema está en la clave o el saldo.
Cuando un 401 sigue a una copia
Una clave pegada con un espacio final o un extremo cortado es una causa común de un 401. Las claves comienzan con sk_, así que verifica ese prefijo y compara toda la cadena con la copia en la página de la cuenta.
Reemplaza la clave en un solo lugar y vuelve a ejecutar la misma llamada única. Cambiar varias cosas a la vez hace que el resultado sea imposible de leer.
Cuando aparece un 402 después de una recarga
Un 402 significa que la acción pagada no tiene créditos restantes. Lee el saldo restante en _credits en la siguiente respuesta autenticada antes de hacer cualquier otra cosa.
Si ese saldo parece correcto, compáralo con el costo de la llamada que falló. Los números mostrarán si la llamada es simplemente más grande que el saldo.
Guarda una nota de la hora en que recargaste, para que el registro y el saldo puedan compararse más tarde.
Una breve nota del saldo antes y después de cada recarga facilita la lectura del próximo 402.
Tratando un resultado vacío
Confirma que la llamada se completó
Lee ok primero. Un valor falso significa que la llamada no terminó, por lo que una lista vacía no te dice nada sobre el dominio.
Verifica el nombre que enviaste
El valor q debe ser un dominio desnudo. Un esquema, una ruta o un espacio extraño pueden producir una respuesta vacía que parece real.
Compara con una acción gratuita
Ejecuta overview en el mismo nombre. Si devuelve datos y el listado no, la acción de listado y sus límites son los siguientes sospechosos.
Verifica la fecha de actualización
El índice se actualiza aproximadamente una vez al mes. Un enlace añadido después de la última actualización no aparecerá, sin importar cuántas veces llames al endpoint.
Política de reintento mínima
- Nunca reintentes automáticamente un 401 o un 402
- Reintenta errores de red con retrasos crecientes
- Detente cuando _credits muestre un saldo cercano a cero
- Guarda en caché las respuestas exitosas durante el mes
- Registra la acción y el dominio con cada fallo
Preguntas de borde
¿Se deducen créditos por una llamada fallida?
No establecemos una regla de facturación para llamadas fallidas en esta referencia. Observa _credits en la siguiente respuesta autenticada y compara el saldo restante con tu expectativa.
¿Por qué funciona una acción gratuita después de un 402?
Porque domain, overview, stats y suggest no necesitan clave ni crédito. Solo las acciones pagadas se bloquean una vez que el saldo está vacío.
¿De dónde provienen los nombres de los campos?
Consulta la entrada de campos de la API para la forma general y llama a un endpoint en vivo para filas específicas de la acción.
Por qué un puntaje puede parecer incorrecto sin ningún error
A veces todos los campos llegan a tiempo y el número aún te sorprende. La respuesta es correcta para su instantánea, por lo que la verdadera pregunta es qué contiene esa instantánea.
Tres situaciones explican la mayoría de estos casos.
Un dominio lanzado recientemente
Un sitio lanzado recientemente puede mostrar DR 0 porque la instantánea es anterior a sus enlaces. Cero aquí significa que no se encontró ningún dominio enlazado, no un veredicto sobre el sitio.
Espera una actualización posterior antes de leer la cifra como un juicio del sitio.
Compara la edad del dominio con el ciclo de actualización antes de actuar. Un nombre nuevo y un nombre antiguo que nunca atrajo enlaces se ven iguales en la misma instantánea.
Un enlace que llegó este mes
Los enlaces añadidos después de la última actualización faltan en la cifra. Una llamada repetida devuelve la misma respuesta hasta que llegue la próxima actualización.
Anota la fecha del enlace y la fecha de la instantánea, para que la brecha sea fácil de explicar para cualquiera que lea el informe.
Un enlace que desapareció
Un enlace puede desaparecer cuando su página se elimina o el sitio donante cierra. El conteo luego disminuye aunque nada cambió en tu lado.
Compara dos instantáneas separadas por unos meses antes de culpar al endpoint.
Cuenta cuántos dominios se mueven, no solo el total. Una pequeña pérdida distribuida en muchos sitios se lee de manera diferente a una gran pérdida de un solo sitio.
Dónde vive cada solución
| Solución | Lugar |
|---|---|
| Clave nueva o copiada | Página de la cuenta |
| Recarga en USDT (TRC-20) | Página de la cuenta |
| Fragmentación y reintento | Tu propio código cliente |
| Esperando una actualización | Nada que hacer; el índice se actualiza aproximadamente una vez al mes |
Reproducir un fallo para un informe de error
Reduce a una llamada
Elimina el bucle y mantén un único comando curl que falle.
Registra la respuesta
Anota el estado HTTP, el valor de ok y el campo _credits si está presente.
Prueba una acción gratuita en el mismo dominio
Si overview funciona y la acción pagada no, el fallo es de clave o saldo, no del dominio.
Envía los detalles
Anota la hora, la acción y los primeros y últimos caracteres de la clave, para que la llamada pueda coincidir con la cuenta. Mantén la clave completa fuera del informe.
Qué registrar con cada llamada fallida
| Registrar | Por qué ayuda |
|---|---|
| Estado HTTP | Separa un 401 de un 402 de un vistazo |
| El valor ok | Muestra si la llamada se completó |
| _credits, cuando está presente | Muestra el saldo en el momento del fallo |
| Acción y dominio | Te permite repetir la misma llamada a propósito |
| Hora de la llamada | La coloca frente a la actualización mensual |
Por qué no auto-reintentar
Bucle en un 402 quema tiempo y no gana nada. Bucle en un 401 puede activar la detección de abuso en cualquier proveedor, el nuestro o el de Google.
Reserva los reintentos para errores de red y dale a cada reintento una pausa más larga que la anterior. Tres intentos es un límite sensato para un trabajo nocturno.
Digamos que un trabajo nocturno encuentra un 402 a las dos de la mañana. Reintentar cada cinco minutos hasta el desayuno produce aproximadamente cien fallos idénticos, y cada uno es una línea de registro que alguien debe leer más tarde.
Usa un límite fijo para los reintentos de red también y registra cada intento. Un límite que puedes declarar en una oración es fácil de defender cuando un trabajo se detiene.
Alertas para un trabajo que se ejecuta sin supervisión
Un trabajo nocturno de verificación del puntaje del dominio debería informar a alguien cuando se detiene, y debería decir por qué. Los dos códigos necesitan alertas diferentes, así que mantenlos separados en el mensaje.
Alerta en el primer 401
Un 401 suele significar un problema de clave, por lo que un solo fallo vale la pena un mensaje. Esperar a cien fallos idénticos solo retrasa la solución.
Incluye los primeros y últimos caracteres de la clave en la alerta, no la clave completa, para que el mensaje sea seguro de compartir con un colega.
Un 402 merece su propio mensaje, ya que su remedio es una recarga en lugar de un cambio de clave.
Un trabajo silencioso no es necesariamente un trabajo saludable. Cuenta las ejecuciones que terminaron, no solo las que fallaron, y alerta cuando ninguno de los conteos se mueve durante un ciclo completo.
Alerta sobre un saldo en caída
Establece la advertencia en un nivel que cubra el resto de la ejecución, no en cero. Un saldo que está casi vacío cuando comienza el trabajo no deja margen para reintentos.
Lee el nivel desde _credits en cada respuesta autenticada, para que la advertencia no necesite una solicitud adicional.
Nuestro rastreador y nuestro índice de enlaces se actualizan aproximadamente una vez al mes. Un sitio lanzado recientemente puede mostrar DR 0, y esa es una lectura correcta de la instantánea, ya que aún no contiene ningún dominio enlazado para el sitio.
