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
Límites según acuerdo. 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.
Flujos de trabajo de ejemplo.
Cuatro ejemplos de lo que puedes construir con la API.
-
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?
El acceso a la API (lectura, escritura y webhooks) está disponible bajo petición — escríbenos a través de la página de contacto. Límites de tasa más altos y SLA, también según acuerdo.
-
¿Dónde encuentro la documentación?
La especificación OpenAPI está en api.mekyn.com/openapi.json y la documentación interactiva en docs.mekyn.com/api. Configuramos el acceso a la API en una sesión de 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?
Los límites se fijan por acuerdo y pueden ampliarse individualmente. 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?
Disponible bajo petición. Acceso anticipado a nuevos endpoints mediante onboarding personal.
¿Preguntas? Alya está aquí para ti.
Conecta tu dominio, publica tu web, revisa la técnica y repara los errores que reportas.
IA Alya: Agente de IA