Inicio rápido
Solicita una API key al administrador del sistema y envíala en cada petición.
curl -H 'X-API-Key: TU_API_KEY' \
'https://mktcalendar.intelector.com/api/marketing-calendar/opportunities?industry=coffee_shop&country=MX&state=JAL&days=60'
Autenticación
Los endpoints de datos requieren una API key. La documentación y el esquema OpenAPI son públicos.
X-API-Key: TU_API_KEY
También puedes usar Bearer:
Authorization: Bearer TU_API_KEY
Las claves se guardan hasheadas; el valor completo solo se muestra al crearlas.
GET
/api/marketing-calendar/opportunities
Devuelve los eventos más relevantes ordenados por urgencia y score, junto con la ventana completa de campaña.
| Parámetro | Tipo | Descripción | Default |
|---|---|---|---|
business_id | integer | Usa automáticamente el perfil, industria y ubicación del negocio. | — |
industry | string | Slug de industria, por ejemplo coffee_shop, hotel o real_estate. | — |
country | string | Código ISO alpha-2. | MX |
state | string | Código estatal, por ejemplo JAL. | — |
days | integer | Horizonte de búsqueda entre 1 y 366 días. | 60 |
min_score | number | Relevancia mínima entre 0 y 100. | 0 |
limit | integer | Cantidad máxima entre 1 y 100. | 25 |
Ejemplo
GET /api/marketing-calendar/opportunities?industry=hotel&country=MX&days=90
Formato estándar
Todas las respuestas mantienen la misma envoltura:
{
"success": true,
"data": [
{
"event": { "name": "Día Internacional del Café", "date": "2027-10-01" },
"score": 91.5,
"urgency": 84.2,
"campaign": {
"prepare_date": "2027-09-10",
"start_date": "2027-09-17",
"peak_start": "2027-09-29",
"peak_end": "2027-10-01",
"end_date": "2027-10-02"
},
"reason": "Alta afinidad con la industria.",
"actions": ["Crear promoción temática"]
}
],
"meta": { "count": 1 },
"errors": []
}Errores
| HTTP | Significado |
|---|---|
401 | API key ausente, inválida o expirada. |
422 | Uno o más parámetros no son válidos. |
429 | Se excedió el límite por hora. |
500 | Error interno registrado por el servidor. |
Rate limit
Cada API key tiene su propio límite por hora. El valor predeterminado es 1,000 solicitudes/hora y puede configurarse desde el panel administrativo.
Esquema OpenAPI
Herramientas, SDKs y agentes pueden consumir la especificación directamente: