Límites de uso

Tipo	Límite por key
Lectura (GET)	120 solicitudes por minuto
Escritura (POST, PATCH, DELETE)	120 solicitudes por hora

Son cupos separados: agotar las lecturas no impide crear pedidos. Las respuestas traen X-RateLimit-Limit y X-RateLimit-Remaining con el cupo de ese tipo de solicitud. Al pasarte recibes 429 rate_limited con el header Retry-After (segundos).

Cómo cuidar el límite

Toda lectura cuenta, aunque Redfloral la responda desde su caché. Lo que ahorra cupo es que tu sistema guarde las respuestas y no consulte en cada visita a tu sitio.

• Precios por lote: no consultes producto por producto. Trae el catálogo completo de una fecha con GET /products/prices?date=<fecha>&page_size=100 (recorre las páginas con has_more) o hasta 100 productos con ids=, y guarda cada precio por producto y fecha.
• Actualiza con webhooks: al recibir product.updated, product.price_changed, product.status_changed o product.deleted, borra ese producto de tu caché. Al recibir availability.changed con type: high_demand, borra los precios de esa date. Reconcilia cada hora con GET /products?updated_since=, porque un webhook se puede perder.
• Disponibilidad por fecha y comuna: guarda delivery-availability sin product_id, para no multiplicar las consultas por producto. Después evalúa cada producto con su is_active y, si high_demand es true, con su is_exclude_high_demand.
• Cuánto guardar la disponibilidad: la de hoy, 1 o 2 minutos, porque la hora de corte depende del reloj y no genera webhook. La de fechas futuras puede durar más, pero bórrala con availability.changed y siempre a medianoche de Chile: cuando una fecha pasa a ser hoy, cambian sus horarios y reglas.

Si recibes 429

Espera Retry-After y, mientras tanto, usa lo último que guardaste en vez de dejar sin datos la ficha o el checkout. Un dato guardado puede estar desactualizado: una fecha que ya no está disponible se crea igual con el aviso date_not_available, y en productos con opciones o variantes (type: 2 y 3) el precio lo calcula Redfloral, así que compara el total de la respuesta con lo que cobraste.