Define el resultado aceptable
Elige el proceso que utiliza publicaciones antiguas de dataengineering. Anota sus campos obligatorios, qué hace cuando falta texto y si depende del orden. Para cada requisito, decide si se admite directamente, necesita tratamiento local o queda fuera de la migración. Así una respuesta HTTP exitosa demuestra una lectura concreta, no la compatibilidad de todo el cliente. Reddit Proxy ofrece un archivo histórico independiente, no la API oficial ni el estado actual de Reddit.
Guarda una página con la nueva clave
Ejecuta GET https://api.redditproxy.com/v1/posts?subreddit=dataengineering&limit=3 usando X-API-Key: <clave> o Authorization: Bearer <clave>. Ambos aceptan la clave del archivo de redditproxy.com, no un token de Reddit OAuth. Conserva parámetros y respuesta para trabajar localmente; excluye el secreto de los archivos de diagnóstico.
El lector de publicaciones utiliza /v1/posts; una lista de comentarios corresponde a /v1/comments, la búsqueda a /v1/search y un registro conocido a /v1/item?id=.... Son operaciones distintas. La consulta individual no trae automáticamente una conversación completa y el servicio no reenvía cualquier URL del cliente anterior.
Transforma campos sin fabricar contexto
Valida el array data y los campos que necesita el informe. Separa un valor ausente de una cadena vacía, y un fallo de conversión local de una página vacía exitosa. Los registros son planos. parent_id y link_id permiten agrupación local cuando existen, pero no son filtros ni garantizan un hilo completo. Reproduce la transformación con la respuesta guardada antes de recuperar más páginas.
Traduce el significado de cada filtro
q busca en title y text con AND entre términos dentro del campo coincidente. No basta con repartir las palabras necesarias entre ambos campos y no es un lenguaje de consultas arbitrario. from y to usan YYYY-MM-DD en UTC, incluido todo el día to. min_score aplica únicamente un umbral numérico. El orden _doc no expresa cronología, relevancia ni puntuación; ordenar localmente solo reorganiza lo ya recibido.
Revisa la condición de fin del recorrido
El máximo es 100 registros por petición y 100 páginas solicitadas por separado para una consulta. Lee total con relation: eq indica un total exacto, gte un límite inferior y unknown un total no fiable, posiblemente null. Desconocido no significa cero. Llegar al límite o dividir por fechas no prueba cobertura exhaustiva ni ausencia de duplicados. Registra las páginas solicitadas y las dudas de cobertura.
Ensaya errores antes de cambiar el informe
Con HTTP 400 corrige parámetros; con 401 revisa la clave, con 402 el saldo y con 429 reduce la frecuencia. Una recuperación exitosa cuesta un crédito aunque esté vacía. Las peticiones inválidas no descuentan y los fallos del origen devuelven la reserva. Si el cliente pierde una respuesta, el servidor puede haber cobrado un éxito; otro intento exitoso cuesta otro crédito.
Compara el informe final con los requisitos iniciales. Una prueba local correcta no garantiza resultados futuros inmutables. Mantén fuera del adaptador las operaciones de escritura y estado actual. /v1/status solo presenta el alcance estático y la respuesta HTTP de la aplicación, no la salud del origen. La documentación, los precios y la página de la clave cubren el contrato, el presupuesto y la cuenta.
