Catálogo público de productos

La API de catálogo público expone únicamente productos globales, activos y publicados. No devuelve datos de organizaciones, suscripciones, accesos, clientes OAuth ni configuración administrativa.

Endpoints

GET /api/public/products
GET /api/public/products/{key}

No requieren autenticación. El listado permite los filtros opcionales category y audience; este último acepta personal u organization.

GET /api/public/products?category=productividad&audience=personal
If-None-Match: "PREVIOUS_ETAG"

Una categoría enviada no puede estar vacía ni superar 100 caracteres. Un valor de audiencia inválido produce 400 Bad Request.

Respuesta

Cada producto incluye contenido comercial publicado, capacidades, pasos de inicio, preguntas frecuentes y precios. Cada precio indica su audiencia y las funcionalidades del plan, incluido su valor y unidad cuando corresponde.

{
  "key": "summit_ai",
  "name": "Summit AI",
  "summary": "Asistencia de inteligencia artificial.",
  "description": "...",
  "category": "productividad",
  "icon": null,
  "iconAltText": null,
  "highlights": ["Modelos especializados"],
  "idealFor": ["Equipos"],
  "capabilities": [],
  "gettingStarted": [],
  "frequentlyAskedQuestions": [],
  "prices": [{ "key": "pro", "name": "Pro", "amount": 20, "currency": "USD", "billingPeriod": "monthly", "description": "Plan mensual.", "features": [], "audience": "personal", "isFeatured": true }]
}

Caché y errores

Las respuestas exitosas incluyen Cache-Control con una vigencia máxima de cinco minutos y un ETag fuerte. Si If-None-Match coincide, el servidor responde 304 Not Modified sin cuerpo.

Un producto inexistente, inactivo o no publicado devuelve el mismo 404, para no revelar su estado interno. La API aplica límite de solicitudes por IP; al agotarlo responde 429 e incluye Retry-After.

Catálogo público de productos

Endpoints

Respuesta

Caché y errores

Ver también