Define qué trabajo permite una acción
Una función que ofrece referencias sobre onboarding necesita una decisión previa: cuántas consultas al archivo puede provocar cada acción del usuario. Reddit API Gateway da a los equipos de infraestructura de producto acceso a un archivo histórico independiente de Reddit, sin afiliación oficial ni actualizaciones en directo. La muestra de SaaS permite definir ese alcance antes de abrir la función a clientes.
Imagina una pantalla que ofrece unas pocas menciones históricas. Tu backend comprueba los permisos y admite un trabajo limitado. Las reglas por usuario y los topes de gasto los implementas tú. La clave identifica la cuenta del dominio que paga las consultas; no asigna roles del producto ni reparte su saldo entre tus clientes.
Pide tres registros y contempla recibir ninguno
El ejemplo es GET https://api.redditapigateway.com/v1/search?q=onboarding&subreddit=SaaS&limit=3. q=onboarding realiza una búsqueda textual, subreddit=SaaS restringe la comunidad y limit=3 pide como máximo tres registros. Sin kind, pueden aparecer publicaciones y comentarios. No clasifica automáticamente recomendaciones de incorporación ni garantiza material pertinente. Envía desde el servidor X-API-Key: <clave> o Authorization: Bearer <clave>; ambas cabeceras se admiten y usan la clave del archivo.
Fragmento sintético, solo demostrativo y sin solicitud real: {"data":[],"pagination":{"page":1,"limit":3,"total":0,"relation":"eq"},"credits":{"cost":1,"balance":99}}. El saldo es ficticio. La lista vacía ilustra un éxito que consume un crédito, aunque tu producto no conserve ningún registro. Guarda la respuesta realmente recibida antes de transformar campos y registrar el progreso local. Una transformación o escritura local fallida no anula el éxito remoto cobrado.
Lleva las cuentas por intento
Para planificar, permite como máximo tres intentos de recuperación por trabajo. Tres solicitudes exitosas cuestan tres créditos, $0.003, aunque no guardes ningún registro útil. Ese límite pertenece a tu aplicación. Incluye cambios de página y reintentos, en lugar de contar únicamente las filas que llegan a la pantalla.
Procesar de nuevo una respuesta guardada no requiere otra consulta al archivo. Pedir una muestra nueva sí puede producir otro cargo y devolver contenido distinto. Si actualizar la selección inicia trabajo de pago, preséntalo como una decisión explícita del usuario, no como una consecuencia invisible de volver a abrir el resultado.
Explica qué representa la selección
La estructura de las respuestas es plana: publicaciones y comentarios son registros individuales, sin árboles ensamblados por el servidor. parent_id o link_id presentes permiten asociaciones locales, sin conversación completa garantizada. El archivo no garantiza cobertura total, resultados inmutables, un esquema constante o disponibilidad permanente. Mantén esas limitaciones junto a la muestra recibida; terminar una tarea de tu producto no demuestra haber recuperado toda la historia de Reddit.
Describe lo mostrado como la muestra recibida. Una página corta no demuestra que SaaS carezca de otras conversaciones sobre onboarding. Agrupar registros localmente tampoco reconstruye una conversación completa. Conserva los parámetros y el contexto de recuperación junto a la selección para que otro miembro del equipo pueda interpretar sus límites.
Prepara el paso de muestra a función
Consulta la documentación para elegir filtros y los precios para dimensionar el presupuesto de llamadas. La página de clave prepara cuenta y saldo; la guía sigue la credencial por el trabajo autorizado y su sustitución. Asigna esas responsabilidades antes de convertir la muestra en una operación habitual del producto.
Antes de abrir la función de onboarding a más usuarios, lleva dos cuentas distintas: los intentos permitidos por acción y el saldo que paga las consultas. Cada recuperación exitosa gasta un crédito, aunque no dé registros utilizables; la tarifa es $1 por 1000 éxitos. La compra mínima de $50 añade 50000 créditos, sin suscripción ni caducidad de los créditos pagados. Una solicitud inválida no descuenta saldo y un fallo del origen devuelve la reserva. Si lo que se pierde es la respuesta en tu cliente, puede existir ya un éxito cobrado; una repetición exitosa se paga aparte. Por eso el contador del trabajo debe registrar las llamadas, no solo las filas que acabaron en pantalla.
