Clasifica la respuesta antes de repetir
Esta API es un archivo histórico independiente y no la aplicación oficial de Reddit, por lo que opera estrictamente en modo de solo lectura. No admite Reddit OAuth, publicación, votos o mensajes privados. Repetir una lectura no modifica el contenido de Reddit, pero puede consumir otro crédito y no garantiza resultados idénticos. Mantén separados el éxito remoto, la recepción del cliente y la transformación de datos en tu aplicación.
Empieza con https://api.redditapiproxy.com/v1/comments?subreddit=devops&limit=3, el ejemplo de la página de inicio. subreddit elige devops y limit pide hasta tres comentarios. Usa X-API-Key: <clave> o Authorization: Bearer <clave> desde tu servidor; ambas cabeceras están admitidas. No transmitas un token Reddit OAuth. Comprueba el estado HTTP antes de interpretar el cuerpo como datos y conserva la respuesta recibida antes de avanzar el progreso local.
Con HTTP 400 revisa los parámetros, no repitas indefinidamente la misma solicitud inválida. Las búsquedas de contenido admiten q, subreddit, author, kind, from, to, min_score, limit y page; kind usa post o comment. from/to siguen YYYY-MM-DD en UTC y filtran created_utc, con el día final completo. /v1/item exige id y /v1/subreddits solo admite prefix y limit. Consulta la documentación antes de trasladar filtros entre rutas.
Corrige credenciales y saldo antes de volver a consultar
HTTP 401 significa clave ausente o inválida. Revisa el dominio, el nombre del encabezado y el secreto configurado, sin imprimirlo en registros. Una respuesta vacía exitosa no indica un problema de clave. Si necesitas regenerarla, entra en el panel de la página Obtener clave API y confirma la contraseña; la clave anterior queda inválida inmediatamente. Actualiza los clientes que la usaban. No hay restablecimiento de contraseña ni envío de claves por correo.
HTTP 402 indica saldo insuficiente. Detén las tareas que requieran créditos y consulta el panel de cuenta; el estado público no muestra el saldo. Para comprar, inicia sesión y crea una factura antes de transferir su importe exacto por la red indicada. Después presenta el hash de la transacción para verificarla. Espera al saldo acreditado sin asumir un plazo: pagar o enviar un hash no demuestra por sí solo que el siguiente intento esté autorizado.
HTTP 429 indica un límite de frecuencia. Puedes programar un número máximo de nuevos intentos con pausas crecientes y cancelar el trabajo al alcanzar ese presupuesto. Es una decisión de tu cliente, sin garantía de recuperación posterior. Evita crear una segunda cadena automática de repeticiones en cada capa de tu aplicación. Los controles de elegibilidad del crédito de prueba operan a escala de red y no describen una clase de pago ni un mecanismo de prioridad.
Conserva las diferencias entre coste, transporte y datos
Una recuperación exitosa cuesta un crédito, incluso vacía. Las solicitudes inválidas no descuentan saldo; los fallos del servicio de origen devuelven la reserva. Una desconexión o un tiempo de espera agotado en el cliente puede suceder después de un éxito cobrado. Otra tentativa exitosa cuesta otro crédito. Tampoco se devuelve automáticamente el coste porque falle tu propia base de datos después de recibir una respuesta válida. Consulta los precios para presupuestar pruebas y repeticiones.
No uses /v1/status como prueba de salud del buscador o validez de la clave. Es público, gratuito y estático, y confirma solo la respuesta HTTP. Para una página de contenido, limit y page van de 1 a 100; min_score filtra sin ordenar y _doc no representa tiempo, relevancia o puntuación. eq expresa total exacto de consulta, gte una cota inferior y unknown un total no fiable, posiblemente null. Ninguno certifica cobertura completa.
Valida data y los campos que necesita tu aplicación. Los registros son planos; parent_id o link_id presentes permiten asociaciones locales, sin conversación completa garantizada. Guarda los datos recibidos antes de marcar la página como terminada. No supongas que una repetición rellena referencias ausentes, conserva el mismo orden o recupera todos los registros que faltan. Dividir períodos o eliminar duplicados localmente organiza el trabajo, pero no demuestra una descarga exhaustiva del archivo.
