Alles wat je moet weten over API’s

Nou ja alles. In ieder geval genoeg om een weloverwogen beslissing te maken of je toe bent aan een API en waar je rekening mee moet houden als je een API wilt laten ontwikkelen. 🙈

Wat is een API?

Je kent het wel, je gebruikt een systeem dat heel handig is, maar het zou nog handiger zijn als het kon ‘praten’ met een ander systeem dat je ook gebruikt. Om dit mogelijk te maken is de API uitgevonden, kort voor ‘Application Programming Interface’. Een “API (spreek uit E-PI-AI en niet apie 🐵 )”. De laatste jaren zijn vooral de REST API’s populair geworden. REST staat voor ‘Representational State Transfer’. Systeem A stuurt een vraag naar systeem B, bijvoorbeeld: “Geef mij de voornaam van klant 1” en systeem B levert de gevraagde data. Met dit vraag en antwoord principe zijn miljoenen systemen aan elkaar gekoppeld. Het kan gaan om een heel eenvoudig proces, zoals het inladen van Instagram afbeeldingen op je website tot een complexe koppeling tussen meerdere administratiesystemen en betaaldiensten. Diensten die bekend zijn geworden om hun API’s zijn bijvoorbeeld betaaldiensten, zoals Mollie en Stripe, nieuwsbriefservice MailChimp en administratiesystemen, zoals Exact Online.

De API, zoals die vaak ‘bedoeld is’ is de functionaliteit die de leverancier van een systeem beschikbaar stelt om ‘mee te praten’ en de documentatie met de noodzakelijke instructies. De API-koppeling is de communicatie die gerealiseerd moet worden tussen de twee systemen, zodat zij met elkaar informatie en instructies kunnen uitwisselen. 

Twee API’s wisselen data uit

Waar moet je rekening mee houden met de ontwikkeling van een API koppeling?

Het realiseren van een betrouwbare API koppeling vraagt de nodige expertise en ervaring. Beginnelingen beweren vaak heel goedkoop en snel een koppeling te kunnen maken, want hoe moeilijk kan het zijn als je de instructie hebt? 10 regels data over en weer sturen duurt niet lang en is niet moeilijk, maar wat als dat er na 5 jaar meer dan 1000, 10 000 of zelfs 100 000 zijn? Wat gebeurd er als er een betaalbevestiging van het ene naar het andere systeem gestuurd is en juist op dat moment een van de twee systemen niet thuis geeft? Hoe zorg je dat het dataverkeer tussen de twee systemen goed afgeschermd is? Al dat soort risico’s en meer moet de koppeling mogelijk rekening mee houden en al die randscenario’s afschermen dat kost veel tijd. Een ontwikkelaar die je niet op dergelijke risico’s wijst of er naar vraagt gaat ze ook niet afdekken met alle gevolgen van dien. Bij API’s is nog altijd: “pay peanuts, get monkeys” het devies.

Wie laat jij een API bouwen?

Welke risico’s brengt een API met zich mee?

Buiten de technische uitdagingen zijn er ook organisatorische problemen waar je tegenaan kunt lopen als twee partijen moeten gaan samenwerken. Is bijvoorbeeld de documentatie wel helemaal bijgewerkt en is overleg tussen de programmeurs mogelijk? Dat klinkt minder logisch dan het is, want probeer jij maar eens een developer bij Facebook, Freshdesk of Apple te spreken te krijgen om een technisch probleem op te lossen. In veel gevallen is het maken van zo’n koppeling ook niet iets waar softwareontwikkelaars enorm om zitten te springen en ze houden er vaak ook geen rekening mee dat jij in de problemen komt als zij ergens de stekker uit trekken. Het is daarom belangrijk dat de partij die de koppeling voor je gerealiseerd heeft door de jaren heen de mogelijke aanpassingen kan maken.

Een goede documentatie is daarom van belang. Zorg ervoor dat je niet afhankelijk bent van het geheugen van een enkele programmeur, maar dat vastgelegd is hoe de koppeling werkt en welke data uitgewisseld wordt door de verschillende systemen. Een professionele ontwikkelaar zal naast de nodige documentatie ook een error log inbouwen. Een stukje code die fouten registreert en aangeeft waar de fout is opgetreden. Er is niets minder efficiënt dan programmeurs in twee systemen te laten zoeken naar een speld in een hooiberg. De crème de la creme is de unit test. Een stukje code die iedere dag alle processen automatisch test en alarm slaat als er een probleem is. Wat je nodig hebt hangt af van de impact die de API op je bedrijfsvoering heeft. Ga je tickets verkopen voor een evenement dan wil je niet dat bij de opening van de kaartverkoop een storing roet in het eten gooit. Haal je een paar afbeeldingen op van Instagram dan is het wellicht geen ramp als eens in de zoveel tijd de verbinding er even uit ligt.

Voor een festival is een betrouwbare kaartverkoop essentieel

Zijn API’s duur?

Een API is eigenlijk nooit te duur, behalve als het niets gaat opleveren. Reken bijvoorbeeld uit hoeveel manuren het nu kost om gegevens van systeem A naar systeem B over te typen en wat het kost als er door dat handwerk fouten in sluipen. Een punt of komma verkeerd en 20 000 Euro kan plotseling 2 000 Euro zijn geworden in de administratie. Een fout die niet mogelijk is met goede automatisering. De vraag is dus niet wat kost een API, de vraag is ‘wat mag het kosten’ en ‘wat levert het op welke termijn op’?

Let wel op dat niet alles te automatiseren is en niet alle automatisering een positief effect heeft. Software systemen zijn namelijk Sith en geen Jedi, ze redeneren in ‘absolutes’. Het is 1 of 0, ja of nee. Direct betalen of een aanmaning. Toegang of geen toegang. Die ene oud bestuurder die je altijd over hebt geslagen met de facturatie of de coulance die je toepast, omdat je weet dat een klant in slecht weer zit. De gekoppelde systemen gaan daar geen rekening mee houden, tenzij je al die uitzonderingen in de programmatuur meeneemt. Meer uitzonderingen betekent niet alleen hogere kosten, maar ook meer complexiteit en wat in de software wereld ‘points of failure’ genoemd worden.

Blijf hip, maar zorg wel voor duidelijke foutmeldingen

Advies voor je een API laat bouwen

Je begint daarom bij het realiseren van een API altijd met het in het kaart brengen van het proces. Vergeet techniek, maar pak eerst pen en papier. Teken uit hoe de ‘flows’ lopen en welke data uitgewisseld moet worden en heel belangrijk wat uiteindelijk het resultaat is van die gegevensuitwisseling. Heb je dat in de smiezen dan kun je gaan kijken wat er technisch mogelijk is, wat de grootste risico’s zijn en wat voor budget daar bij zou passen. Uiteraard bieden veel webbureau’s en digital agencies, zoals Studio Projectie aan om de processen, risico’s en mogelijke winst in tijd en geld voor je in kaart te brengen.

Begin ook waar mogelijk klein als je start met automatiseren. Zeker als je nog niet eerder met API ontwikkeling in aanraking bent gekomen kun je voor grote verrassingen komen te staan. Maak het voor je zelf behapbaar, want als jij het beoogde proces zelf al niet snapt dan is het voor een programmeur onmogelijk om het goed te automatiseren. Het allerduurste is namelijk ‘achteraf’ te ontdekken dat het toch niet lekker werkt of dat je de helft van de stappen vergeten bent. Door stap voor stap te werken en alles goed te testen kun je het proces beter volgen en controleren of het allemaal klopt.

Zo zie je dat er achter de wereld van API’s heel veel schuilgaat. Heb je zelf al eens overwogen om een API te gaan ontwikkelen? Wil je meer weten over API’s of vraag je je af of twee van je favoriete systemen met elkaar zouden kunnen ‘praten’? Wij horen graag meer!

Weet jij wie echt je doelgroep is?

Heb je jezelf wel eens betrapt op een uitspraak als: “Wij zijn die mensen die bij mijn concurrent kopen?” of “Waar komen die mensen vandaan die… ?”. Het begrijpen van je doelgroep is een belangrijke stap naar online succes en door te ontdekken wie je doelgroep eigenlijk is en waar zij naar op zoek zijn voor je een website, webshop of product laat bouwen of ontwerpen, kun je betere keuzes maken en slimmer investeren.

Je doelgroep toen en nu

Ik weet nog dat een jaar of 10 geleden op de informatica opleiding niet een, maar zelfs twee dames bij mij in de klas zaten. Dat was toen nog vrij bijzonder, want zij waren de enige dames in een nieuwe lichting van +/- 300 studenten. Het was vrij gemakkelijk om een marketingcampagne op de andere 298 informatica studenten los te laten. Wij hadden ongeveer allemaal dezelfde interesses: computers, gamen, films en elektronische muziek. Steve Jobs was onze profeet en in de pauzes haalden we broodjes met kroketten en andere snacks. Schoolboeken kocht je niet, want je had immers het internet tot je beschikking en je laptop meenemen was al ‘zwaar‘ genoeg.

Een typische gedachte, wanneer je niet goed weet wie je doelgroep is of die van je concurrent.

Vergelijk ik dat met ons personeel nu dan is het beeld heel anders. Toen de pandemie insloeg was ik verbaasd dat sommige collega’s geen snellere computer thuis hadden dan op werk of een comfortabele bureaustoel, want die heb je toch nodig om te gamen? Een andere collega had er vooral moeite mee dat hij zich niet meer kon uitleven in zijn boksschool. Denk je dus in 2021 alle webdesigners en developers te kunnen bereiken door een stereotype nerd te targeten die thuis achter de computer zit dan sla je de plank mis. Je verkoopt niet aan een collectief, maar aan een individu en je moet zien te ontdekken wat die individuen aan je product, merk of diensten verbind. Ik hoor je al denken: “Ja dat weet ik”, maar waarom antwoord dan 9 van de 10 ondernemers als ik de vraag stel: “voor wie is je website bedoeld?” altijd met “iedereen, foodies, ondernemers, vrouwen met kinderen” en andere generieke doelgroepen? 

Twee moderne webdesigners, Armando en Michenou die allebei dezelfde boeken lezen. De wereld is diverser geworden en je verkoopt niet meer aan een collectief van mensen, maar aan individuen en dat maakt het moeilijker om doelgroepen te onderscheiden en te bereiken.

Het juiste profiel kan je idee maken of breken

Als je niet goed weet wie je doelgroep is dan kan het beste idee ter wereld alsnog sneuvelen. Neem bijvoorbeeld Pinterest. Een handig appje, waarmee je foto’s en inspiratie kunt verzamelen en met andere kunt delen. Wat je misschien niet wist is dat Pinterest op de rand van de afgrond heeft gestaan, omdat ze niet zo goed hadden nagedacht over hun doelgroep. In eerste instantie richtte Pinterest zich op creatievelingen, zoals kunstenaars, artiesten en webdesigners. Zij konden met Pinterest immers gemakkelijk moodboards maken. Echter bleek al snel dat Pinterest moest gaan strijden met software van anderen en artiesten over het algemeen niet de meest lucratieve doelgroepen zijn. De groei ging  langzaam en meer marketing zette geen zoden aan de dijk door de hoge concurrentie.

Pinterest ging eens goed kijken naar de bezoekersstatistieken om erachter te komen wie de app eigenlijk gebruikte. Toen kwamen zij tot een opvallende ontdekking. Pinterest werd namelijk vooral gebruikt door vrouwen en veel minder door mannen. Toen zij dieper in de data gingen graven kwam het beeld naar boven dat het volwassen vrouwen waren tussen de 30 en 50 die accounts hadden aangemaakt en niet de millennial creatievelingen op wie zij hun pijlen gericht hadden. Pinterest is voor de dames die thuis of op kantoor achter hun laptop of tablet kruipen niets meer of minder dan een digitaal plakboek. Zij gebruiken PInterest om kledingcollecties en tuin inspiratie te verzamelen en wanen zich binnenhuisarchitect dankzij de productafbeeldingen van IKEA en onderling delen ze de collecties. Concreet zijn de gebruikers vrouwen tussen de 30 en 50 jaar. Een bovengemiddeld inkomen speelt ook een rol, want met een lege portemonnee kun je niet onbezorgd shoppen. Pinterest pastte de marketingstrategie aan om specifiek deze doelgroep te targeten door onder andere met IKEA samen te gaan werken en behaalde binnen mum van tijd succes.

IKEA plaatst op haar beurt de beste deals direct op Pinterest.

De primaire, secundaire consument

Wat hierboven omschreven is, is is de primaire consument van Pinterest. De doelgroep die echt naar je product of dienst op zoek is en waarschijnlijk bereid is om er voor te betalen of interessant is voor adverteerders. Dat is in dit geval niet “iedereen”, maar een specifieke groep vrouwen. Secundaire consumenten zijn er ook, zoals de dochters van de huismoeders die de eigen IKEA spulletjes bij elkaar mogen klikken. Tot slot zijn er dan ‘growth customers’. Wellicht valt er nog groei te behalen door hen te bereiken, maar dat vraagt wel meer moeite. Wat als je bijvoorbeeld met een extra investering Pinterest zo gemakkelijk maakt dat zelfs oma er mee aan de slag kan? Oma, moeder en (klein)dochter. De potentiële doelgroep verdriedubbeld! Misschien ben jij terwijl je dit leest net als Pinterest ook wel in de verkeerde vijver aan het vissen zonder dat je het weet.

De daadwerkelijke gebruikers

Ga eerst ontdekken voor je gaat bouwen met een discovery

Als je niet goed hebt nagedacht over je doelgroep loop je het risico dat je meest geniale idee alsnog mislukt. Je hebt waarschijnlijk ook niet altijd toegang tot zoveel data als een techreus als Pinterest of dezelfde eindeloze fondsen, subsidies en belastingkortingen als Silicon Valley om zonder eigen risico te experimenteren. Het is daarom belangrijk om voor je een website, webshop, webapplicatie of ander digitaal product laat ontwikkelen of ontwerpen eerst een discovery te doen. Tijdens een discovery ga je samen met een groepje van experts met verschillende specialismen, zoals UX design(gebruikerservaring), marketing en techniek onderzoeken wat je zou moeten ontwikkelen, wat je uniek maakt en misschien nog belangrijker wie de consumenten of eindgebruikers eigenlijk zijn en waar zij op zitten te wachten. Je kunt namelijk wel op facebook gaan adverteren, omdat je concurrent dat doet. Je logo gaan vernieuwen, omdat het trendy is of snel gaan bouwen om een arbitraire zelfverzonnen ‘deadline’ te halen of binnen een uit de lucht gegrepen budget te blijven, maar dan kun je net zo goed een casino binnen lopen om je geluk te beproeven. 

Waarom zou je in 2021 nog blind schieten op basis van assumpties en een alles-of-niets risico lopen als de data en kennis die je inzicht geeft in hoe het echt zit voor het oprapen ligt? Dat doe ik ook niet en daarom heb jij dit nu gelezen.

Ondanks dat veel beroepen thuis uitgeoefend kunnen worden is de kans groot dat je door de coronavirus maatregelen minder kunt doen dan normaal. Afspraken gaan niet door, offertes worden nog niet geaccepteerd en sommige collega’s zijn ziek of afwezig. Je kunt je achterstand van TV series en films gaan inhalen, grote hoeveelheden WC papier kopen,
een goed boek lezen, Fortnite spelen of….

Een beeldbank maken

Heb je veel ongesorteerde foto’s dan is nu het ideale moment om alles netjes te gaan archiveren en categoriseren in een beeldbank. Ideaal voor wanneer je een geschikt plaatje nodig hebt voor je social-media posts of website. Wist je dat je met je Google (Business Suite) e mailaccount gratis gebruik kunt maken van Google Photo’s?

Je metadata (her)schrijven

Vindbaarheid vinden we belangrijk, maar we besteden er allemaal te weinig tijd aan. Nu is het moment om al je pagina’s te voorzien van een passende meta description! Kies per pagina een steekwoord, en vertel in 140 tot 160 tekens waar een pagina over gaat en vergroot daarmee de vindbaarheid op Google! De meeste WordPress websites zijn voorzien van een Yoast SEO plugin om dit per pagina netjes in te vullen. Heb je de plugin niet vraag ons dan om hulp om de plugin te installeren!

Evalueer je website en de statistieken

Hoe staat je website er eigenlijk voor. Log weer eens in op Google Analytics om te zien hoeveel bezoekers je op je website hebt mogen ontvangen. Is je website geschikt voor mobiele apparaten, sluit het verhaal nog goed aan bij je huidige aanbod en zijn de foto’s nog up to date? Is je online etalage al ouder dan 5 jaar dan is het wellicht tijd om na te denken over een nieuwe website. Wij geven je graag gratis en vrijblijvend advies over de staat van je website en andere online-marketing kanalen en dat kan allemaal op afstand vanuit je luie stoel geregeld worden.

Werk je socials bij

Wanneer heb je voor het laatst de omschrijving van je bedrijf of organisatie op Facebook aangepast? Heb je nog steeds het haar dat je had op je profielfoto en kloppen de adresgegevens op LinkedIn nog wel? Hoe zit het eigenlijk met je privacy instellingen en wachtwoorden? Je hebt nu alle tijd om de boel weer eens bij te werken.

Update! Update! Update!

De updates van je telefoon, iPad, computer, VR-bril, browser en Smart TV die je normaal altijd snel wegklikt beschermen je tegen digitale virussen en lossen bugs op. Nu is het ideale moment om al je apparaten weer eens langs te lopen voor de nieuwste updates. Wellicht wil je ook je website updaten en ook dat is een goed idee. Beheren wij je website dan kijkt onze helpdesk graag even met je mee, zodat we zeker weten dat je website optimaal blijft werken.

Maak je eerste landingspagina

Camiel schreef onlangs een mooi blog over het maken van landingspagina’s. Leer wat nieuws en ga aan de slag om je eigen conversie kanon te maken dan is je omzet na de corona pandemie snel weer op peil.

Ga bloggen of vloggen

Wilde je altijd al eens gaan bloggen dan is nu het moment om te gaan starten. Schrijf over je werk, hobby’s, passies, weetjes of mooie verhalen. Met deze tips kun je direct aan de slag!

Maak je toetsenbord en muis schoon

Je toetsenbord en muis gebruik je dagelijks en zijn een bron van schadelijke bacteriën. Vaak hebben ze een stoer zwart kleurtje, zodat de troep niet zo opvalt. Haal er eens een keukenpapiertje overheen…. oei! Haal eerst de stekkertjes uit je computer. Pak bij voorkeur keukenpapier of een katoenen doekje, neem een beetje spiritus of een ander schoonmaakmiddel dat geschikt is om randapparatuur te reinigen en laat je toetsenbord weer glimmen! Ben jij een echte techneut, schroom dan niet om je PC kast eens open te maken en een stofdoekje langs je fans te halen. Pas wel op dat je geen onderdelen beschadigd. Op YouTube staan veel handige PC cleaning filmpjes.

Koop een nieuwe computer

Tot slot. Hoe oud is de computer of laptop eigenlijk die je gebruikt? 3, 5 of 10 jaar? Heb je al een SSD of ratelt en piept je PC nog net zo hard als in 2010? Met een nieuwe computer kun je veel sneller werken om straks je corona achterstand in te halen. AMD heeft recent kekke Ryzen 3000-serie processoren op de markt gebracht die goede performance bieden voor betaalbare prijzen. Gun jezelf een nieuwe iPad met een handige pen of vervang die oude logge laptop met een mooie Notebook. Een bijkomend voordeel is dat je nu alle tijd hebt om je nieuwe speeltjes te ontdekken en te installeren. Je mag de bezorger best bedanken, maar geen handen schudden natuurlijk!

Wacht geduldig af en volg goed de instructies van de RIVM

Eer dat je deze lijst hebt afgewerkt dan is het coronavirus waarschijnlijk als sneeuw voor de zon verdwenen. Blijf tot die tijd waakzaam en luister naar de instructies van de overheid om verdere besmettingen tegen te gaan. 

Zelf een handtekening maken of laten maken

Op het internet zijn er ontzettend veel tools en tutorials te vinden. Veel email providers zoals Outlook of Gmail geven je de mogelijkheid om een simpele handtekening te maken. Echter bij de wat spannendere handtekeningen is er wel kennis van HTML nodig. De uitdaging is om een handtekening te maken, die in alle mailprogramma’s goed weergegeven wordt.

Wij van Studio Projectie kunnen dit natuurlijk voor jou maken.