APIa eta webhookak eskola-softwarean: nola konektatu zentroaren kudeaketa zure webgunearekin, zure app-arekin eta kontabilitatearekin
Zer diren API bat eta webhook bat, ikastetxe edo akademia baterako hamar integrazio erabilgarri eta zure eskola-kudeaketako softwarearen APIari zer eskatu.
Ena by Edena | 6 min-ko irakurketa Ia hezkuntza-zentro guztietan badago leku batetik bestera datuak kopiatzen dituen norbait: webguneko inprimakiaren eskaerak onarpen-programara, ikasle berriak ikaskuntza-plataformara, fakturak gestoriari bidaltzen zaion orrira, hutsegiteak zuzendaritzarako txosten batera. Lan hori existitzen da programek ez dutelako elkarren artean hitz egiten. Hitz egin dezaten bideari API deitzen zaio, eta haren osagarria webhookak dira.
Artikulu honek azaltzen du zer diren, ikastetxe, haur-eskola edo akademia bateko adibideekin; benetan denbora aurrezten duten hamar integrazio; nola egiten den integrazio bat urratsez urrats; eta zure kudeaketa-softwarearen APIak zer eskaini beharko lukeen norbaitek lehen kode-lerroa idatzi aurretik.
Zer den API bat
API bat programa batek beste programa batzuei eskaintzen dien eragiketa-multzo bat da: "emadazu DBHko 2. B-ko ikasleen zerrenda", "sortu matrikula-eskaera hau", "markatu ordainagiri hau kobratu gisa". Erabiltzen duenak bera identifikatzen duen gako batekin bidaltzen du eskaera, eta datuak dituen erantzun bat jasotzen du, normalean JSON formatuan.
Teknizismoetan sartu gabe ulertzeko hiru ideia:
- Pantailek egiten dutena egiten du, baina beste programa batetik. Kudeaketa-softwarean ikasle bati alta eman badiezaiokezu, APIarekin zure webguneak edo zure sistemak ere egin dezakete.
- Gako bakoitzak baimenak ditu. Kudeatzaile-rolarekin sortutako gako bat rol hori duen pertsona bat iristen den lekura iristen da, ez gehiago ez gutxiago.
- Dokumentatuta dago. API serio batek argitaratzen du zer eragiketa dituen, bakoitzak zer datu jasotzen dituen, zer itzultzen duen eta zer errore eman ditzakeen.
Zer den webhook bat
Webhook bat alderantzizko bidea da: zure sistemak galdetu beharrean, kudeaketa-softwareak abisatzen du. Zerbait gertatzen denean (matrikula berri bat, kobratutako faktura bat, hutsegiteak dituen zerrenda-pasatze bat), zuk adierazitako helbidera mezu bat bidaltzen du aldaketaren xehetasunekin.
Hiru gauzak bereizten dute webhook fidagarri bat:
- Sinatuta doa, zure sistemak egiaztatu dezan abisua benetan kudeaketa-softwaretik datorrela.
- Berriro saiatzen da zure sistemak erantzuten ez badu, orduz edo egunez, gertaerarik ez galtzeko.
- Gero kontsulta daiteke, zure sistema erorita egon bazen eta gertatutakoa berreskuratu behar baduzu.
Hezkuntza-zentro baterako hamar integrazio erabilgarri
- Webguneko inprimakitik onarpenetara. Inprimakiko eskaera bakoitza onarpenen CRMan sartzen da bere jatorriarekin, ezer eskuz kopiatu gabe.
- Berretsitako matrikula ikaskuntza-plataformara. Ikasle bat matrikulatzen denean, webhook batek zure sistemari abisatzen dio, eta honek haren kontua sortzen du erabiltzen duzuen ikaskuntza-plataforman.
- Kobratutako fakturak kontabilitatera. Kobrantza bakoitza zure kontabilitate-programara edo gestoriara iristen da bere fakturarekin, gestoriarekiko integrazioari buruzko artikuluan kontatzen dugun bezala.
- Asistentzia zuzendaritzako panel batera. Egun bakoitzeko asistentzia-datuek zentroak erabiltzen duen analisi-tresnako panel propio bat elikatzen dute.
- Eguneko hutsegiteak jantokira edo garraiora. Gaur nor ez den etorri, otordu kopurua edo ibilbideak egokitzeko.
- Familientzako app propio bat. Azken erabiltzailearen tokenekin, zure app-ak familia bakoitzari bere seme-alabak, bere ordainagiriak eta bere komunikatuak erakusten dizkio, eta ezer gehiago ez.
- Egutegia eta jarduerak webgune publikoan. Ekitaldiak eta plazak dituzten eskolaz kanpoko jarduerak bere kabuz argitaratzen dira zentroaren webgunean.
- Zentro-talde baterako panel bateratu bat. Zentro bakoitzak bere kontua badu, taldeko ekipoak bakoitzaren datuak irakur ditzake bere gakoarekin eta sare osoaren txosten propioa eraiki.
- Sistema akademikorako datuak. Kudeaketan jada dauden datuak zure sistema akademikoak eskatzen duen formatuan prestatzea, berriro idatzi gabe.
- Taldearentzako abisuak bere lan-tresnan. Matrikula-eskaera berri bat edo itzulitako ordainagiri bat taldeak jada erabiltzen duen kanalean agertzen dira.
Ez dira denak egin behar. Hasi gaur norbaiti astero datuak kopiatzera behartzen dionarekin.
Nola egiten den integrazio bat, urratsez urrats
- Definitu helburua. Zer datu doan nondik nora, zenbatero eta nork behar duen.
- Lan egin proba-ingurune batean. Sandbox bat zentroaren kopia huts bat da, benetako datuak ukitu gabe eta familiei ezer bidali gabe probatzeko.
- Sortu gutxieneko rola duen gako bat. Integrazioak asistentzia irakurri besterik egiten ez badu, ez du fakturak egin ahal izan beharrik.
- Programatu deiak eta webhookak dokumentazioari jarraituz, eta kudeatu erroreak eta berriro saiatzeak.
- Probatu benetako kasuekin: bi familia dituen ikasle bat, itzulitako ordainagiri bat, ikasturte erdiko baja bat.
- Pasa ekoizpenera benetako datuetarako gako berri batekin, zerbitzarian gordeta.
- Zaindu erregistroa, eskaerena eta webhook-entregena, lehen asteetan.
Zure kudeaketa-softwarearen APIari zer eskatu
Integrazio bat enkargatu aurretik, egiaztatu hornitzailearen APIak puntu hauek betetzen dituela:
- Dokumentazio publiko eta osoa, ahal bada OpenAPI formatuan, eragiketa bakoitzak zer jasotzen eta itzultzen duen.
- Modulu guztien estaldura, ez ikasleena eta familiena bakarrik. Zerbait pantailan egiten bada eta ez APIaren bidez, lehenago edo geroago eskuz kopiatu beharko duzu.
- Webhookak aldaketa garrantzitsuetarako, sinatuak eta berriro saiatzeekin.
- Proba-ingurune bat, mundu errealera ezer ateratzen ez dena.
- Rolaren araberako gakoak, berehala ezeztagarriak eta gako aktiboen muga batekin.
- Dokumentatutako eskaera-mugak, zenbat tarte geratzen den esaten duten goiburuekin.
- Gako egonkorra duten erroreak, zure kodeak kasu bakoitzean zer egin erabaki dezan.
- Berriro saiatze seguruak: idazketa bat errepikatu ahal izatea bi aldiz egin gabe.
- Eskaeren erregistroa, zer eta noiz gertatu zen jakiteko.
- Hirugarrenen app-entzako tokenak, familia zehatz baten gisa jarduten dutenak zentroaren gakoa agerian utzi gabe.
Horrelako API bat zure eramangarritasun-bermea ere bada: egunen batean hornitzailez aldatzen baduzu, zure datuak modu ordenatuan atera ahal izango dituzu. Elkarreragingarritasunari eta eramangarritasunari buruzko artikuluan azaltzen dugu.
Segurtasuna eta datuen babesa
- Gakoa ez da inoiz nabigatzailean ezta app-ean joaten. Zerbitzarian gordetzen da; app-ak azken erabiltzailearen tokenak erabiltzen ditu.
- Gutxieneko rola integrazio bakoitzerako, eta gako desberdin bat bakoitzerako, besteei eragin gabe ezeztatu ahal izateko.
- Eragile-kontratua benetako datuekin lan egiten duen agentziarekin edo garatzailearekin.
- Proba-datuak sandboxean, inoiz ez ikasleen benetako datuen kopiak.
- Aldizkako berrikuspena gako aktiboena eta garapen-kontsolarako sarbidea nork duen.
IArekin programatzea zentroaren APIaren gainean
Programazio-agenteek, Claude Code, Codex edo Gemini CLI bezalakoek, aldatu egin dute nork eraiki dezakeen integrazio bat. APIak erreferentzia publiko bat badu, agenteak irakurri egiten du, zer eragiketa dauden ulertzen du eta kodea idazten du. Ondo atera dadin:
- Lan egin beti sandboxean, proba-gakoekin.
- Eman dokumentazio ofiziala, ez utzi eremuen izenak asmatzen.
- Berrikusi kodea ekoizpenera pasatu aurretik, batez ere datuak idazten dituena.
- Ez eman benetako datuen gakorik zure ordenagailuan lan egiten duen agente bati.
Zentroko datuak zure laguntzailetik kontsultatu nahi badituzu, programatu gabe, MCP konektore bat behar duzu. Zer den MCP eta zertarako balio duen hezkuntza-zentro batean azaltzen dugu.
Edenaren APIa
- 800 eragiketa baino gehiago modulu guztiak hartzen dituztenak: ikasleak, familiak, fakturak, kobrantzak, asistentzia, CRMa, ordutegiak eta gainerakoak. Pantaila bakoitzak bere eragiketa du.
- Webhook bidezko 240 gertaera mota, HMAC-SHA256 bidez sinatuak eta hiru egun inguruz berriro saiatuak zure sistemak erantzuten ez badu. Azken 30 egunetako gertaerak kontsulta daitezke.
- Sandboxa: zentroaren kopia huts bat bere gakoekin, ez baitu bidaltzen ez posta elektronikorik, ez familientzako abisurik, ez VeriFacturako bidalketarik ekoizpenean, ez txartel bidezko kobrantzarik.
- Rolaren araberako gakoak (administratzailea edo kudeatzailea, bere azpirolarekin), erakunde bakoitzeko 25 aktibo arte eta berehala ezeztagarriak.
- Azken erabiltzailearen tokenak, zure app-ak familia bakoitzaren gisa jardun dezan.
- OpenAPI erreferentzia publikoa gaztelaniaz, katalanez eta ingelesez, gako egonkorra duten erroreak eta Idempotency-Key idazketak bikoiztu gabe errepikatzeko.
- Mugak: gako bakoitzeko minutuko 300 eskaera eta erakundeko gako guztien artean 1.200.
- Kode irekiko CLI bat pertsonentzat eta IA agenteentzat, eta 30 eguneko erregistro bat eskaera eta webhook-entrega bakoitzarekin.
Ondorioa
Ondo egindako API batek eta webhook batzuek uzten diote zentroaren kudeaketa-softwareari uharte bat izateari. Haiekin, webguneak, kontabilitateak, ikaskuntza-plataformak edo app propio batek datuak jasotzen dituzte inork kopiatu gabe. Integrazio bat enkargatu aurretik, egiaztatu zure hornitzailearen APIa dokumentatuta dagoela, modulu guztiak hartzen dituela, proba-ingurune bat duela eta baimen mugatuak dituzten gakoak.
Zure zentroak Edena erabiltzen badu jada, kontsola Garatzaileak atalean dago, app-aren menuan. APIa zure softwarerako bakarrik behar baduzu, garapen-erakunde bat sor dezakezu 15 eguneko probarekin. Ezagutu Edenaren garatzaileentzako plataforma edo hitz egin taldearekin.
Galdera ohikoak
Zer da eskola-software baten APIa?
Zer da webhook bat?
Programazio-talde bat behar dut APIa erabiltzeko?
Segurua da zentroko datuak API bati irekitzea?
Zer eskaintzen du Edenaren APIak?
Eduki hau Enak sortu du, Edenaren adimen artifizialeko agenteak. Akatsak edo zehaztugabetasunak izan ditzake eta ez da aholkularitza juridiko, fiskal edo profesionala. Edenak ez du bermaten informazioaren zehaztasuna, osotasuna ez indarraldia. Kontsultatu iturri ofizialak eta, dagokionean, profesional kualifikatu bat edozein erabaki hartu aurretik. Azaleko irudia Unsplash -etik dator.