API's en koppeling­en

Een stukje uitleg.

Application Programming Interfaces (APIs), of ook wel koppelingen, zorgen er voor dat het ene stuk software, data kan uitwisselen met een ander: bijvoorbeeld de software waarmee jij je klanten beheert, je voorraad kan bijhouden of je online betalingen mee faciliteert. Een API is een afspraak over hoe dit moet gebeuren, en zorgt voor de uitwisseling. Dat gaat over data-bronnen, data-formaten, welke functies er beschikbaar zijn en nog veel meer.

Goede voorbeelden van koppelingen die wij gemaakt hebben zijn onder andere de cursusinformatie koppeling voor ACTA, de Mollie donatie koppeling voor Trees for All of de Microsoft Dynamics CRM koppeling bij Edukans.

Het is overigens niet zo dat een koppeling altijd een externe partij is: wij zetten API’s ook vaak in om binnen een online product data uit te wisselen. Je kan het gebruiken om bijvoorbeeld mooie en snelle applicaties te maken zonder dat je lang hoeft te wachten op laden, maar het is ook in te zetten voor schaalbaarheid. Door een bepaalde functionaliteit heel specifiek, geïsoleerd en snel te maken en deze te ontsluiten via een API, kunnen verschillende onderdelen er gebruik van maken zonder dat je alles hoeft aan te passen! Dat hebben we bijvoorbeeld gedaan voor de Film van het Jaar verkiezing van de VPRO, of de assessment software van Online Testcenter.

Hoe we dit doen

Bij September werken we dagelijks aan allerlei koppelingen. Ze zijn vaak kernonderdeel van het maken van nieuwe online producten of digitalisering van organisaties. Waar wij extra op letten is het volgende:

We stemmen eerst samen af wat de einddoelen zijn, welke data er heen en weer moet — en hoe deze bereikbaar moet zijn. Dit doen we samen: niet alleen met onze opdrachtgevers en developers, maar ook met een UX-er. Data-integriteit, veiligheid en privacy staan hoog in het vaandel, en met automatisering moet je extra goed opletten.

We houden het graag simpel. We starten met een proof of concept van de koppeling, zorgen dat we alles kunnen uitwisselen en maken het daarna mooi. Extra tijd besteden we aan het bekijken of we niet ‘gewoon alles maar uitwisselen’. Dat is niet nodig, en brengt risico’s met zich mee.

We denken ver vooruit over onderhoudbaarheid en duurzaamheid van de koppeling. We willen een langdurige werkzame functionaliteit opleveren — die gegarandeerd de juiste data door blijft sturen. We schrijven daarom documentatie, draaien uitgebreide Quality Assurance rondes en werken met meerdere developers die elkaars werk controleren.