API pubblica
Automatizza tutto ciò che si ripete.
API REST e webhook per ogni endpoint di mekyn — contenuti, report SEO, lead, build, azioni di dominio. Crea i tuoi strumenti, sincronizza con Notion o Slack, o usa mekyn come backend del tuo stack.
Sei elementi per l’automazione
-
API REST
Endpoint REST completamente documentati per CRUD su Sites, Pages, Blocks, Domains e Leads — entra JSON, esce JSON.
-
Webhook
Eventi: site.published, lead.received, seo.report.ready, backlink.detected, social.posted — firmati con HMAC-SHA256.
-
OAuth 2.0
Autenticazione basata su token con ambiti (read:sites, write:pages, manage:leads). Rotazione dei token in un clic.
-
Limiti di frequenza trasparenti
Limiti di frequenza concordati su richiesta. L’header X-RateLimit-* mostra la quota rimanente.
-
Specifica OpenAPI
Specifica OpenAPI 3.1 completa — genera automaticamente client con sicurezza dei tipi in TypeScript, Python, Go e Ruby.
Flussi di lavoro di esempio.
Quattro esempi di ciò che puoi costruire con l’API.
-
Sincronizzazione CMS da Notion
Un cron job legge le tue pagine Notion e invia i contenuti come blocchi mekyn al CMS. Notion è la fonte, mekyn è il frontend.
-
Flusso di lead su Slack
Il webhook "lead.received" avvisa un canale Slack con i dettagli del lead e un link diretto al lead su mekyn.
-
Report SEO su Looker Studio
Un cron giornaliero estrae le metriche SEO via API e le invia a BigQuery — Looker le visualizza.
-
Deploy automatico al push su Git
Una GitHub Action chiama l’endpoint API "site.rebuild" — avvia la build e il sito è online in 30 secondi.
Esempio · 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 }
# } Domande frequenti
-
In quali piani è inclusa l’API?
L’accesso all’API (lettura, scrittura e webhook) non fa parte dei piani Start e Business: è disponibile su richiesta, insieme a limiti di frequenza e SLA.
-
Dove trovo la documentazione?
La specifica OpenAPI è su api.mekyn.com/openapi.json e la documentazione interattiva su docs.mekyn.com/api. Configuriamo l’accesso all’API in una sessione di onboarding personale.
-
I webhook sono affidabili?
Sì. In caso di risposta di errore (>=500 o timeout) riproviamo con backoff esponenziale fino a 24 ore. I payload non riusciti vanno in una coda di messaggi morti che puoi visualizzare nel pannello.
-
E i limiti di frequenza?
I limiti li concordiamo su richiesta, con aumenti individuali possibili. Gli header X-RateLimit-Limit / X-RateLimit-Remaining / X-RateLimit-Reset mostrano lo stato. In caso di superamento: HTTP 429 con Retry-After.
-
L’API è conforme al GDPR?
Sì. Tutti gli endpoint vengono eseguiti esclusivamente su server negli USA/UE (configurabile). I log di audit di tutte le chiamate API vengono conservati per 90 giorni. I dati personali nei payload dei webhook sono cifrati a riposo.
Pronto per l’accesso all’API?
Disponibile su richiesta. Accesso anticipato ai nuovi endpoint tramite onboarding personale.
Domande? Alya è qui per te.
Collega il tuo dominio, pubblica il tuo sito, controlla la tecnica e ripara gli errori segnalati.
IA Alya: Agente IA