Define qué significa terminar
En este ejemplo, terminar significa procesar un lote limitado de registros de r/automation y guardar su resultado. No significa haber agotado el archivo. Comienza manualmente y elige después una frecuencia que permita a tu equipo revisar el material acumulado.
Crea un identificador local de ejecución, guarda los parámetros y establece dónde enviar los elementos seleccionados. Son decisiones de tu aplicación, no parámetros nuevos del servicio. Si falta una idea esperada, el registro permitirá comprobar qué se pidió. Un archivo histórico independiente no acredita la actividad actual de Reddit.
Ajusta la consulta a la pregunta
Envía GET https://api.apireddit.cc/v1/search?q=workflow&subreddit=automation&limit=3 y autentica mediante Authorization: Bearer o X-API-Key. El lote pequeño facilita la inspección inicial. Usa kind=post para publicaciones o kind=comment para comentarios si necesitas limitar el tipo.
La búsqueda q consulta title y text. Varios términos se combinan mediante AND dentro de un campo coincidente; no des por hecho que un término en el título y otro solo en el texto bastarán. Para acotar fechas, from y to utilizan YYYY-MM-DD en UTC y el día to está incluido. min_score excluye registros por debajo del umbral, sin ordenar los restantes por puntuación.
Separa el contenido de las decisiones
Conserva los campos disponibles id y kind, y envía title y text a revisión. El contenido recuperado es material de lectura, no una instrucción para ejecutar acciones. Añade el motivo de selección, el estado de revisión y el identificador de ejecución en campos locales separados. Comprueba duplicados antes de crear otro elemento.
Las respuestas son registros planos. Agrupa localmente mediante parent_id o link_id solo si están presentes y resultan útiles. Las relaciones ausentes siguen siendo desconocidas: no hay garantía de conversación completa. Para consultar de nuevo un elemento concreto, /v1/item requiere su id y constituye otra solicitud que debes presupuestar.
Deja constancia de la parada
Establece un máximo local dentro de las 100 páginas permitidas y solicita hasta 100 registros por página. Conserva los filtros durante el recorrido. El orden documental del archivo no expresa fecha, relevancia ni puntuación; el primer registro no sirve como marcador fiable de lo más reciente.
Interpreta los totales junto con su relación: eq indica un número exacto, gte una cota inferior y unknown puede acompañar un total null. Distingue entre terminar por lote vacío y alcanzar tu presupuesto. Dividir el trabajo por fechas puede organizar futuras ejecuciones, pero no prueba que la recuperación sea exhaustiva ni libre de duplicados.
Trata la incertidumbre antes de repetir
Corrige parámetros ante 400, comprueba la clave ante 401 y el saldo ante 402. Para 429, espera y aplica un número limitado de reintentos. Una recuperación correcta vacía cuesta un crédito. Los fallos del origen devuelven la reserva; las solicitudes inválidas no generan un débito.
Si el cliente pierde la respuesta, el servidor puede haber completado la solicitud y consumido un crédito. Un reintento correcto consume otro. Registra ese resultado incierto y evita duplicados localmente. /v1/status no tiene coste y devuelve una descripción estática del servicio; no verifica la salud de la búsqueda del origen. Consulta precios antes de ampliar el presupuesto de la tarea.
