API, webhook e MCP

Tutto quello che vedi nell’app, lo puoi chiamare.

Chiavi API con i permessi del contesto, webhook firmati per ogni evento dell’accademia, documentazione con esempi veri e un server MCP che mette corsi, registro e calendario a disposizione degli assistenti AI.

  • Chiavi API per accademia o per persona, mostrate una sola volta
  • Webhook con eventi a scelta, firma HMAC, retry e log
  • Stessa API dell’app: corsi, presenze, studenti, calendario
  • Server MCP per Claude, ChatGPT e Cursor
Impostazioni API keysAccademia LeonardoMarco Bianchi
Impostazioni
Gestisci l’account, le chiavi e le integrazioni dell’accademia.
Profilo
Account
Fatturazione
API keys
Webhook
MCP
Aspetto
Notifiche
API keys
Accesso programmatico per Accademia Leonardo.
Le chiavi autenticano le richieste all’API di Aladia (header apikey) con i permessi di questo contesto. Nuova chiave
Chiave predefinita(predefinita)
Nessuna scadenza
••••••••••••a9F2
Integrazione CRM
Nessuna scadenza
••••••••••••aZq
Registro elettronico · sync
Scade tra 312 g · 3 ago 2027
••••••••••••7kQ1
Make · automazioni
Nessuna scadenza
••••••••••••mX4c
Nuova API key
La chiave agisce con i permessi di questo contesto: trattala come una password.
Nome
Integrazione CRM
Scadenza
Nessuna scadenza
Genera chiave
La tua nuova API key
Copiala adesso e conservala al sicuro: in lista comparirà mascherata.
ald_sk_9Kp2mQ4xR7tW1nB8vC3yH6jL0sD5fG2aZq
Copia chiave
Copiato
Fatto
Funzionalità

Un’API sola, la stessa dell’app

Il registro elettronico, il CRM, il gestionale e gli assistenti AI parlano con Aladia come fa l’interfaccia: nessuna scorciatoia, nessun dato in più.

Webhook con eventi a scelta

Un endpoint, gli eventi che ti servono: course.published, course.completed, course.installment.paid, organization.member.added. Ogni consegna è firmata; se l’endpoint risponde male, riproviamo cinque volte con attesa crescente e tieni il log.

Impostazioni WebhookAccademia LeonardoMarco Bianchi
Impostazioni
Gestisci l’account, le chiavi e le integrazioni dell’accademia.
Profilo
Account
Fatturazione
API keys
Webhook
MCP
Aspetto
Notifiche
Webhook
Consegna degli eventi in tempo reale per Accademia Leonardo.
Endpoint che ricevono un POST HTTP quando accadono gli eventi sottoscritti: pubblicazioni, iscrizioni, pagamenti. Nuovo webhook
CRM sync
https://crm.accademialeonardo.it/hooks/aladia
5 eventi98%Attivo
Registro elettronico
https://registro.accademialeonardo.it/aladia
3 eventi100%Attivo
Modifica
Consegne
Disattiva
Elimina
Consegne di CRM sync
https://crm.accademialeonardo.it/hooks/aladia
Eventi sottoscritti
course.published course.completed course.installment.paid organization.member.added member.invited
TutteRiusciteFallite
500course.installment.paid24 set, 15:41
185.94.12.7 · Internal Server Error
200course.installment.paid24 set, 15:41
185.94.12.7 · tentativo 2
Nuovo tentativo 2/5 tra 4 s
200course.published24 set, 15:32
185.94.12.7
200organization.member.added24 set, 15:20
185.94.12.7
200member.invited24 set, 15:19
185.94.12.7
200course.completed23 set, 18:02
185.94.12.7
Firma HMAC verificata con il secret del webhook

Payload leggibile, firma verificabile

Ogni evento porta l’id, la risorsa e i dati: titolo del corso, ciclo, materie, chi ha pubblicato. L’header con la firma HMAC ti permette di scartare tutto quello che non arriva da Aladia.

Impostazioni WebhookAccademia LeonardoMarco Bianchi
Impostazioni
Gestisci l’account, le chiavi e le integrazioni dell’accademia.
Profilo
Account
Fatturazione
API keys
Webhook
MCP
Aspetto
Notifiche
Webhook
Consegna degli eventi in tempo reale per Accademia Leonardo.
CRM sync
https://crm.accademialeonardo.it/hooks/aladia
5 eventi98%Attivo
Registro elettronico
https://registro.accademialeonardo.it/aladia
3 eventi100%Attivo
Consegna
course.published · CRM sync
Richiesta
POSThttps://crm.accademialeonardo.it/hooks/aladia
Content-Type:application/json
X-Aladia-Event:course.published
X-Aladia-Delivery:dlv_01JAB3X7K2Q9M4
X-Aladia-Signature:sha256=4f9a1c…e21b
Risposta
…
200 OK · 184 ms
Ogni consegna porta l’evento, la risorsa e i dati; la firma nell’header permette di verificarla.
Corpo
{
"id": "evt_01JAB3X7K2Q9",
"event": "course.published",
"createdAt": "2026-09-24T15:32:10.412Z",
"resource": { "type": "course", "id": "66f2a1c4e9b3d8a7c5f01234" },
"data": {
"title": "Liceo Scientifico · 1° anno",
"type": "live",
"organization": { "id": "66e0b7…", "name": "Accademia Leonardo" },
"cycle": { "start": "2026-09-07", "end": "2027-06-05" },
"subjects": ["Matematica", "Fisica", "Italiano", "Latino", "Storia"],
"publishedBy": { "id": "66e1c9…", "name": "Marco Bianchi" }
}
}
ReinviaFatto

Documentazione con esempi veri

docs.aladia.io descrive ogni endpoint con parametri, esempio di richiesta in cURL, Node e Python e risposta reale: GET /v2/courses/:courseId/attendance-registry restituisce lezioni e righe di presenza con stato, fonte e minuti in aula.

docs.aladia.io/api/courses/attendance-registry
ALADIA Documentazione API Cerca nella documentazione…⌘Kapp.aladia.io
Introduzione
Autenticazione
Corsi
Registro presenze
Studenti
Calendario
Webhook
MCP
Corsi Registro presenze
Registro presenze di un corso
GET/v2/courses/{courseId}/attendance-registry
Le lezioni del corso (svolte e future) e le righe di presenza: stato, fonte, minuti in aula e copertura della registrazione.
Chiave API nell’header apikey · permessi del contesto
Parametri
courseIdstringpathId del corso
cycleIdstringqueryLimita a un ciclo
profileIdstringqueryUn solo studente
lectureIdstringqueryUna sola lezione
RichiestacURLNodePython
curl "https://api.aladia.io/v2/courses/66f2a1c4…/attendance-registry" \
-G --data-urlencode "lectureId=66f9d2b1…" \
-H "apikey: ald_sk_••••••••aZq"
Risposta200application/json
{
"course": { "id": "66f2a1c4…", "title": "Liceo Scientifico · 1° anno" },
"cycle": { "start": "2026-09-07", "end": "2027-06-05" },
"lectures": [{ "id": "66f9d2b1…", "title": "Matematica · Equazioni",
"date": "2026-09-24T08:00:00Z", "status": "done" }],
"rows": [
{ "name": "Giulia Esposito", "status": "present", "source": "live",
"liveMinutes": 58, "liveCoverage": 0.97 },
{ "name": "Marco Gallo", "status": "late", "source": "live",
"liveMinutes": 46, "lateMinutes": 12 },
{ "name": "Andrea Ricci", "status": "remote", "source": "recording",
"recordingCoverage": 0.86 },
{ "name": "Alice Barbieri", "status": "absent", "source": "live" }
]
}

Server MCP dell’accademia

Attivi il server, scegli gli ambiti (corsi, studenti e presenze, calendario, chat) e colleghi i client: Claude, ChatGPT, Cursor. Ogni client usa la chiave API di chi lo collega e le sue azioni finiscono nell’Activity log.

Impostazioni MCPAccademia LeonardoMarco Bianchi
Impostazioni
Gestisci l’account, le chiavi e le integrazioni dell’accademia.
Profilo
Account
Fatturazione
API keys
Webhook
MCP
Aspetto
Notifiche
MCP
Server Model Context Protocol per Accademia Leonardo.
Server MCP dell’accademia
Qualsiasi assistente compatibile con MCP (Claude, ChatGPT, Cursor) può leggere e agire sui dati dell’accademia con i permessi di chi si collega.
Disattivo
Attivo
URL del server
https://mcp.aladia.io/accademia-leonardo
Ambiti 48 strumenti esposti
Corsi e ciclicourses:read
Studenti e registro presenzestudents:read
Calendario: crea e sposta lezionicalendar:write
Chat: scrive nei canalichat:write
Pagamentipayments:read
Client collegati
A\
Claude
collegato il 12 set 2026 · ultimo uso 2 min fa
Revoca
G
ChatGPT
collegato il 18 set 2026 · ultimo uso 40 min fa
Revoca
›_
Cursor
collegato il 24 set 2026 · ultimo uso adesso
Collegato ora
Configurazione del client
"mcpServers": {
  "aladia": {
    "url": "https://mcp.aladia.io/accademia-leonardo",
    "headers": { "apikey": "ald_sk_••••••••aZq" }
  }
}
La chiave API decide cosa l’assistente può fare; ogni azione finisce nell’Activity log.

Un assistente esterno che lavora nell’accademia

"Elenca gli studenti a rischio del Liceo Scientifico e crea una lezione di recupero venerdì alle 15": l’assistente chiama list_students_at_risk, poi create_lecture, e ti mostra chi ha invitato. Con i permessi di chi chiede, non uno di più.

A\Claude
Nuova chat
Recenti
Studenti a rischio · Scientifico
Bozza circolare genitori
Piano lezioni Fisica ottobre
Accademia LeonardoAladia · Accademia LeonardoMCP · 48 strumenti
Studenti a rischio · Scientifico Aladia · Accademia LeonardoMarco Bianchi
Elenca gli studenti a rischio del Liceo Scientifico e crea una lezione di recupero venerdì alle 15.
A\
aladia · list_students_at_risk{ "course": "Liceo Scientifico · 1° anno", "threshold": 75 }
Completato
In corso
Andrea RicciAndrea Ricci68%sotto la soglia del 75 %
Chiara ColomboChiara Colombo71%sotto la soglia del 75 %
Alice BarbieriAlice Barbieri74%sotto la soglia del 75 %
aladia · create_lecture{ "title": "Recupero Matematica", "start": "2026-10-02T15:00", "teacher": "Davide Ricci", "invite": 3 }
Completato
In corso
Recupero Matematica · Liceo Scientifico · 1° annoven 2 ott · 15:00 – 16:00 · Davide Ricci · Andrea Ricci, Chiara Colombo, Alice Barbierilec_66fa1d…

Tre studenti del Liceo Scientifico · 1° anno sono sotto la soglia di presenza del 75 %: Andrea Ricci (68 %), Chiara Colombo (71 %) e Alice Barbieri (74 %).

Ho creato la lezione «Recupero Matematica» venerdì 2 ottobre alle 15:00 con Davide Ricci e ho invitato i tre studenti. La trovi nel calendario dell’accademia.

Apri in Aladia Registrato nell’Activity log come Marco Bianchi
Scrivi a Claude…
Aladia · Accademia Leonardo
Le azioni sull’accademia usano i permessi di Marco Bianchi.
Come si lavora

Come si lavora

  1. 1

    Crea la chiave

    Settings › API keys: nome, scadenza, chiave copiata una sola volta. Agisce con i permessi del contesto (accademia o persona).

  2. 2

    Sottoscrivi gli eventi

    Settings › Webhook: URL, eventi, test immediato. Il secret firma ogni consegna; il log mostra esito e tentativi.

  3. 3

    Collega gli assistenti

    Settings › MCP: attivi il server, scegli gli ambiti, incolli la configurazione in Claude, ChatGPT o Cursor.

Cosa c’è dentro

Chiavi per contesto
La stessa pagina serve il profilo e l’accademia: decide la sessione. Nessuno scope da inventare: valgono i ruoli.
Header apikey
Una chiave, un header. Niente OAuth da configurare per le integrazioni interne.
Catalogo eventi
Eventi raggruppati per categoria (corsi, organizzazione, calendario, pagamenti, chat, social) con ricerca.
Retry e log
Cinque tentativi con backoff esponenziale; log per webhook con filtro riuscite/fallite e codice di risposta.
OpenAPI
Specifica generata dal gateway: gli stessi DTO dell’app, sempre allineati.
Permesso Developer
Chiavi e webhook richiedono il ruolo Developer (owner e admin lo ereditano); le azioni sono nell’Activity log.

Domande frequenti

Costruisci la tua Academy. Trova la tua Academy.

Unisciti a 194.000+ studenti e a centinaia di insegnanti e organizzazioni già su Aladia.