API de gestió escolar per a desenvolupadors Tot el que fa Edena, des del teu codi

Més de 800 operacions, un esdeveniment per cada canvi, una CLI per a tu i el teu agent d'IA, i un connector per a Claude i ChatGPT. Cada clau actua amb un rol del centre i arriba exactament al mateix que una persona amb aquest rol.

Instal·la la CLI
$ npm install -g @edena-solutions/cli

30 dies de prova, sense targeta de crèdit.

El teu centre ja fa servir Edena? La consola és a Desenvolupadors, al menú de l'app.

edena login · Autoritzar la CLI d'Edena · Sandbox · edena students list · edena skill install

Quatre maneres de construir sobre Edena

A sota de tot hi ha la mateixa API. Crida-la des del teu servidor, rep cada canvi al moment, treballa des del terminal o deixa que la teva app parli com cada família.

API REST

Alumnes, factures, assistència, CRM, horaris: cada pantalla d'Edena té la seva operació. Envia la clau a la capçalera Authorization i rep JSON, amb els seus tipus a la referència OpenAPI.

A punt per a producció des de la primera petició

El que esperes d'una API seriosa, amb el seu comportament escrit a la referència.

Reintents sense duplicats

Envia cada escriptura amb Idempotency-Key i repeteix-la durant 24 hores: respon el mateix que la primera vegada i no la fa dues vegades.

› Idempotency-Key: 5f0c2e9a-…

Errors amb una clau estable

Tots els errors responen amb el mateix cos. Decideix amb key, que no canvia, i guarda el requestId. Hi ha més de 400 claus documentades.

› "key": "auth.api_key_in_browser"

Límits que es llegeixen

300 peticions per minut per clau i 1.200 entre totes les de l'organització. Cada resposta diu quant marge queda; per sobre, 429 amb Retry-After.

› X-RateLimit-Remaining: 287

Referència OpenAPI pública

Cada operació amb el que rep, el que retorna i els seus errors, en català, castellà i anglès. La CLI i els agents la llegeixen per no inventar res.

› GET /openapi.json?lang=ca

Un sandbox de veritat

Una còpia buida del teu centre amb les seves pròpies claus. Res no en surt: ni correus, ni avisos, ni VeriFactu en producció, ni cobraments amb targeta.

› edn_test_…

Tu decideixes qui escriu a les famílies

Si la teva app parla amb les famílies, apaga els correus i avisos d'Edena per a elles. El personal i l'equip de desenvolupament continuen rebent els seus.

› 409 organization.family_messaging_off

Cada petició, amb el seu rastre

La consola guarda 30 dies de peticions amb el seu requestId, la latència p95 i cada lliurament de webhook amb el que va respondre el teu sistema.

› X-Request-Id: 0190f4d2-…

Un prompt per categoria

Copia el prompt d'una categoria des de la documentació o executa edena prompt: el teu agent implementa la integració amb els tipus exactes.

› edena prompt invoices

Connector MCP Edena a Claude i ChatGPT

Cada persona de l'equip connecta el seu assistent amb el seu propi compte i pregunta pel centre en el seu idioma. L'assistent veu i fa el mateix que aquella persona a Edena, mai més.

Funciona a
  • Claude
  • ChatGPT
  • Claude Code
  • Codex
  • Gemini CLI
  • GitHub Copilot
  • Cursor
  • Qualsevol client MCP remot
  1. Quants alumnes de 3r B van faltar ahir?
  2. Ahir van faltar 2 dels 24 alumnes de 3r B. Una de les absències ja la va justificar la família des de l'app.
  3. Convoca les seves famílies a una reunió dijous a les 17:00.
  4. Fet. La reunió ja és al calendari de 3r B.

Es connecta en un minut

  1. 1

    Afegeix l'adreça

    Al teu assistent, com a connector personalitzat. A Claude és a Configuració, Connectors.

  2. 2

    Aprova l'accés a Edena

    Tries el centre i si l'assistent només consulta o també pot fer canvis.

  3. 3

    Pregunta en el teu idioma

    Cerca l'operació, l'executa com tu i et resumeix la resposta. Abans de cada canvi et demana confirmació.

Sis eines

Les de canvi només apareixen si la persona ho va permetre en connectar-lo.

  • whoami Consulta Com qui actua: persona, centre, rols i si pot canviar dades.
  • search_operations Consulta Cerca operacions de l'API amb paraules senzilles.
  • describe_operation Consulta Descriu una operació amb els seus paràmetres i tipus.
  • read_operation Consulta Fa una consulta com la persona.
  • prepare_change Canvi Prepara un canvi sense fer-lo i ensenya què farà.
  • apply_change Canvi Fa el canvi confirmat, una sola vegada.

El que un assistent no fa mai

Encara que la persona ho pugui fer a Edena.

  • Factures i diners, només a Edena

    Emetre o anul·lar factures, cobraments, devolucions, moneders i remeses es fan sempre des d'Edena.

  • Permisos i configuració, tampoc

    Qui pot fer què, l'equip i la configuració del centre no es canvien des d'un assistent.

  • Dades sensibles, ocultes

    Dades bancàries, documents d'identitat, dades de salut i credencials li arriben ocultes.

  • El centre decideix

    Un administrador tria quins rols poden connectar un assistent i els pot desconnectar tots al moment.

Fins a 120 crides per minut per persona i 1.200 per centre. El que l'assistent llegeix ho processa el seu proveïdor, amb el compte de la persona.

I l'Ena? L'Ena és la IA que ja viu dins d'Edena, al web i a l'app. El connector és per a qui prefereix treballar des del seu propi assistent. Coneix l'Ena

Així entra el teu equip de desenvolupament

Qui desenvolupa amb vosaltres té el seu propi compte i la seva consola, sense veure les dades del centre. En quatre passos fa la seva primera petició.

Convida qui desenvolupa

A Desenvolupadors, Equip. Un administrador de desenvolupament crea claus i convida; un desenvolupador consulta la documentació, les peticions i el consum. Els administradors del centre ja formen part de l'equip.

Només necessites l'API?

Crea una organització de desenvolupament

Tots els mòduls per API per al teu propi programari, amb la consola, el sandbox i les claus, sense la suite de gestió. 30 dies de prova, sense targeta.

Crear un compte de desenvolupador

Preguntes freqüents de desenvolupadors

El que sol preguntar qui integra Edena per primera vegada.

Què pot fer una clau d'API?
Actua amb el rol amb què es va crear, administrador o gestor (amb el seu subrol, si en té), i arriba exactament al mateix que una persona amb aquest rol. Si li falta un permís, l'API respon 403. Una organització pot tenir fins a 25 claus actives, i cadascuna es revoca en segons des de la consola.
He de fer servir Edena al meu centre per utilitzar l'API?
No. Si el teu centre ja fa servir Edena, la consola és a Desenvolupadors, al menú de l'app. Si només vols l'API per al teu propi programari, crea una organització de desenvolupament: té tots els mòduls per API, la consola i el sandbox, amb 30 dies de prova sense targeta.
Puc provar sense tocar dades reals?
Sí. Des d'Entorn crees un sandbox: una còpia buida del teu centre amb les seves pròpies claus (edn_test_). D'allà no surten correus ni avisos a famílies, no s'envia res a VeriFactu en producció i no es cobra amb targeta. El pots restablir quan vulguis.
Com s'assabenta el meu sistema dels canvis?
Amb webhooks: cada canvi a Edena (una alta, una factura cobrada, una assistència) arriba al teu endpoint com un POST signat amb HMAC-SHA256, i es reintenta durant uns tres dies si no respon. GET /webhook-events llista els esdeveniments dels últims 30 dies, i en local edena listen te'ls reenvia sense adreça pública.
La meva app pot actuar com cada família?
Sí, amb tokens d'usuari final. El teu servidor els demana amb una clau d'administrador i els lliura a l'app, que arriba al mateix que aquella família a les apps d'Edena: els seus fills, les seves factures, els seus comunicats i el seu calendari. Si la família no té compte a Edena, se'n crea un només per a la teva app. Una clau enviada des d'un navegador respon 403.
Què fa el connector per a Claude i ChatGPT?
Permet que cada persona de l'equip faci servir Edena des del seu assistent d'IA, amb el seu compte i els seus permisos. Consulta el que la persona pot veure i, si ella ho permet, prepara canvis que només es fan quan els confirma. No emet mai factures, no mou diners ni canvia permisos o configuració, i no rep dades bancàries, d'identitat ni de salut.
Quina diferència hi ha entre l'Ena i el connector?
L'Ena és la IA d'Edena: viu dins del web i de l'app, amb el context del centre. El connector porta Edena a l'assistent que ja fa servir cada persona, com Claude o ChatGPT. En tots dos casos es respecten els permisos de cada persona i els canvis es confirmen abans de fer-se.
Qui pot entrar a la consola de desenvolupadors?
Els administradors del centre i les persones que convideu a l'equip de desenvolupament, com a administrador de desenvolupament o com a desenvolupador. Qui només és desenvolupador entra a la consola, mai a les dades del centre.
Quins límits té l'API?
300 peticions per minut per clau i 1.200 entre totes les claus de l'organització. Amb tokens d'usuari final, 300 per persona i 6.000 entre totes les de l'app. Cada resposta indica quant marge queda, i per sobre l'API respon 429 amb Retry-After.

Secretaria tanca el mes sense anar darrere de les famílies

Les factures surten amb Verifactu, l'assistència queda registrada i cada família ho veu a l'app. Veure-ho amb un centre com el teu són 15 minuts.

Parlem