API pública
Automatiza todo lo que se repite.
API REST y webhooks para cada endpoint de mekyn — contenido, informes SEO, leads, builds, acciones de dominio. Crea tus propias herramientas, sincroniza con Notion o Slack, o usa mekyn como backend de tu stack.
Seis piezas para la automatización
-
API REST
Endpoints REST totalmente documentados para CRUD sobre Sites, Pages, Blocks, Domains y Leads — entra JSON, sale JSON.
-
Webhooks
Eventos: site.published, lead.received, seo.report.ready, backlink.detected, social.posted — firmados con HMAC-SHA256.
-
OAuth 2.0
Autenticación basada en tokens con ámbitos (read:sites, write:pages, manage:leads). Rotación de tokens con un clic.
-
Límites de tasa transparentes
1.000 peticiones/hora en el plan Pro, 10.000 en Max. La cabecera X-RateLimit-* muestra la cuota restante.
-
Especificación OpenAPI
Especificación OpenAPI 3.1 completa — genera automáticamente clientes con seguridad de tipos en TypeScript, Python, Go y Ruby.
-
GraphQL (hoja de ruta)
Endpoint GraphQL previsto para el T4 de 2026. REST sigue disponible en paralelo — sin cambios con ruptura.
Flujos de trabajo de ejemplo.
Cuatro casos de uso que nuestros beta testers ya están ejecutando.
-
Sincronización de CMS desde Notion
Un cron job lee tus páginas de Notion y envía el contenido como bloques de mekyn al CMS. Notion es la fuente, mekyn es el frontend.
-
Flujo de leads a Slack
El webhook "lead.received" avisa a un canal de Slack con los detalles del lead y un enlace directo al lead en mekyn.
-
Informe SEO en Looker Studio
Un cron diario extrae las métricas SEO por API y las envía a BigQuery — Looker las visualiza.
-
Despliegue automático al hacer push en Git
Una GitHub Action llama al endpoint de API "site.rebuild" — arranca el build y el sitio está en línea en 30 segundos.
Ejemplo · cURL
curl https://api.mekyn.com/v1/sites \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json"
# {
# "data": [
# { "id": "smith-plumbing", "domain": "smithplumbing.com", "status": "live" },
# { "id": "dr-jones-clinic", "domain": "drjonesclinic.com", "status": "live" }
# ],
# "meta": { "total": 2, "page": 1 }
# } Preguntas frecuentes
-
¿En qué planes está incluida la API?
Acceso de solo lectura a partir del plan Plus. Acceso de escritura y webhooks a partir del plan Pro. Límites de tasa más altos y SLA a partir de Max.
-
¿Dónde encuentro la documentación?
La especificación OpenAPI está en <a href="https://api.mekyn.com/openapi.json" class="underline">api.mekyn.com/openapi.json</a> y la documentación interactiva en <a href="https://docs.mekyn.com/api" class="underline">docs.mekyn.com/api</a>. Ambos endpoints están en construcción — el acceso anticipado se hace mediante onboarding personal.
-
¿Son fiables los webhooks?
Sí. Ante una respuesta de error (>=500 o tiempo de espera agotado) reintentamos con retroceso exponencial hasta 24 horas. Los payloads fallidos van a una cola de mensajes muertos que puedes ver en el panel.
-
¿Qué hay de los límites de tasa?
Pro: 1.000/h. Max: 10.000/h, con aumentos individuales posibles. Las cabeceras X-RateLimit-Limit / X-RateLimit-Remaining / X-RateLimit-Reset muestran el estado. Al exceder: HTTP 429 con Retry-After.
-
¿Cumple la API el RGPD?
Sí. Todos los endpoints se ejecutan exclusivamente en servidores de EE. UU./la UE (configurable). Los registros de auditoría de todas las llamadas a la API se conservan 90 días. Los datos personales en los payloads de los webhooks se cifran en reposo.
¿Listo para el acceso a la API?
Incluido a partir del plan Pro. Acceso anticipado a nuevos endpoints mediante onboarding personal.