De Public API van Ekkli: gegevens automatisch ophalen

Ekkli's Public API geeft alleen-lezen toegang tot de evenementen, preekgegevens en openbare pagina's van je gemeente, zodat een andere website of een ontwikkelaar ze automatisch kan overnemen. De Public API is een betaalde uitbreiding van € 25 per maand, los van welk abonnement je hebt, bij geen enkel abonnement inbegrepen en geen onderdeel van de gratis proefperiode. Deze pagina legt uit wat de Public API doet, waar de grenzen liggen, en wat ze niet dekt.

Wat de Public API wel doet

De Public API leest de evenementen, preekgegevens en openbare pagina's van je gemeente op Ekkli en stelt ze beschikbaar aan een ander systeem: een eigen website, een aangepast dashboard, of een agendasysteem dat je evenementen automatisch overneemt in plaats van dat iemand één keer per maand met de hand een CSV-bestand exporteert. Toegang loopt via een token, en het aantal opvragingen is begrensd. Persoonlijke gegevens zijn via de Public API op geen enkel moment bereikbaar.

Waar de grenzen liggen

De Public API is bewust smal gehouden. Lezen wel, schrijven niet: via de API kan er niets naar Ekkli teruggeschreven worden. En ze dekt alleen openbare inhoud: geen ledenlijst, geen roosters en geen gegevens over giften. Wie een tweerichtingskoppeling nodig heeft, of programmatisch bij leden- of giftengegevens wil kunnen, vindt dat bij Ekkli op dit moment niet.

Waarom één login vaak al genoeg is

Bij de meeste gemeentes doet één platform al veel van wat elders een API voor nodig zou zijn. Presentatie tijdens de dienst, gemeentewebsite met ledenportaal, ledenadministratie, rooster en aanmelden voor evenementen lopen al onder één login. Heb je gegevens nodig die de Public API niet levert, dan blijft alleen de handmatige weg over, meestal een CSV-export.

Aanbieders met een uitgebreidere API

Kan een koppeling niet wachten, en heb je meer nodig dan de Public API biedt, dan bieden een paar gevestigde platforms een aanzienlijk bredere API-toegang.

Elvanto publiceert een API voor personen, vrijwilligers, groepen, diensten en evenementen, met lees- en schrijftoegang tot de belangrijkste gegevens. ChurchTools gaat nog verder, met een gepubliceerde catalogus van meer dan 800 API-eindpunten, zonder meerprijs. FellowshipOne (F1) biedt een REST-API die gemeentes en gekwalificeerde partners gratis kunnen gebruiken. ChurchSuite, IconCMO en Text In Church bieden ook een vorm van API- of open datatoegang, mocht je breder willen zoeken.

Dat zegt niets ten nadele van Ekkli: deze platforms hebben hun API-toegang uitgebouwd omdat hun klanten daar jarenlang om hebben gevraagd. Ekkli's aanpak gaat er vooralsnog van uit dat de meeste gemeentes juist minder systemen met elkaar willen verbinden, niet meer. Daarom lopen presentatie, website, leden en evenementen al onder één login. Heeft jouw gemeente toch bredere API-toegang nodig, dan is een van de genoemde aanbieders een redelijk startpunt.

Als je meer nodig hebt dan de Public API biedt

Beschrijf via onze contactpagina precies welke koppeling je nodig hebt: welk systeem, welke gegevens, één of twee richtingen op, hoe vaak. Een concreet verzoek van een echte gemeente weegt zwaarder mee in de verdere ontwikkeling dan een algemene functiewens. En elk bericht wordt gelezen.

Deze pagina wordt bijgehouden door het Ekkli-team en beschrijft de daadwerkelijke stand van het product. Verandert de omvang van de Public API, dan wordt deze pagina daarop aangepast. Vragen hierover? Neem contact op.