Alya si occupa di questa paginaTecnica web · Agente IA

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.

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.

Tecnica web

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