fb
API Management 7 minuten

API-portfoliomanagement was de missende schakel

Hans Bot
Hans Bot
Senior Solution Architect
Blog 18 1
Scroll

Lekker shoppen

Blog-18-1

Als je een mogelijk praktisch product tegenkomt in een magazine of op een website zul je het eerst onderzoeken. Misschien bewust, misschien onbewust, kijk je naar de grammatica, het lettertype, de kleurzetting en de kwaliteit van de foto’s. Als je besluit te gaan lezen (opgepast, dat is op zich is al een besluit), dan zoek je naar gestructureerde, makkelijk te verwerken, beknopte en interessante informatie. Als je dan nog steeds geïnteresseerd bent, zul je een kijkje nemen naar de reviews en of er ook iets bekend is over de betrouwbaarheid van de aanbieder. Hoe lang wordt het product al geleverd? Zijn er nieuwere versies beschikbaar? Hoe heeft de prijs zich ontwikkeld? Na dit onderzoek heb je wellicht voldoende vertrouwen gewonnen om er zeker van te zijn dat aankoop je niet tegen gaat vallen en besluit je het product te kopen.

Impulsieve kopers

O, dan zijn er natuurlijk ook impulsieve kopers die niet zo veel om achtergrondonderzoek geven. Zij zijn over het algemeen makkelijker te overtuigen. Het enige wat je nodig hebt is dat je ze kunt enthousiasmeren en dat je ze belooft dat ze hun geld terugkrijgen als ze het product terugsturen.

Zou dit nou werkelijk anders zijn als het product dat aangeboden wordt een API is?

Van buiten naar binnen denken

Het beste advies wat je kunt krijgen is waarschijnlijk dat je van buiten naar binnen moet gaan denken. Dat geldt zeker als je succes wilt boeken met API’s. Het van buiten naar binnen denken is eigenlijk het proberen te begrijpen wat het aanvaardingsproces is dat jouw abonnees meemaken en dat zo verleidelijk mogelijk aanbieden. Op deze manier ga jij het voor elkaar krijgen:

1. Verminder wrijving

Maak het makkelijk om jouw API te ontdekken. Publiceer hem waar je verwacht dat jouw potentiële abonnees zoeken. Zorg ervoor dat je goed scoort in zoekmachines. Geef het een pakkende naam. Schrijf er blogs over, maak er een podcast van en verspreid het op YouTube, LinkedIn, Github, StackOverflow en Slack. En, het belangrijkste van alles, wees actief betrokken: deel succesverhalen en zorg dat het gesprek op gang blijft. Voorkom dat je product er verlaten uitziet.

Zorg er ook voor dat bezoekers jouw API makkelijk kunnen testen. Dat is vaak de eerste indruk die ze hebben. Deel sample code, biedt een SDK in een taal naar keuze. Denk aan goede gelokaliseerde versies van je API Developerportaal.

2. Breng het kooptraject van de klant in kaart

Een API in je applicatie embedden kan een grondige klus zijn, want uiteindelijk geef je jouw gebruikers een functie waar jijzelf geen controle meer over hebt. Als je erover nadenkt kan dat zowel opwindend als spannend zijn. En waarschijnlijk zul je erover na moeten denken.

Personas kan een grote hulp zijn bij het personifiëren van bepaalde groepen in het acceptatieproces van een API. Probeer je voor te stellen waar deze personen heen gaan om API’s te ontdekken, wat vinden zij aantrekkelijk en wat stoot ze af. In de hyper-gepolariseerde wereld waarin we leven is het maar al te gemakkelijk om negatieve gevoelens op te roepen. Het kiezen voor een natuurlijke benadering zou kunnen helpen om over het hele spectrum van leeftijden, culturen en politieke interesses uit te stijgen.

Bouw een community

Aan de andere kant kan een gerichte aanpak de band met jouw publiek versterken en aan de ontwikkeling van een community bijdragen. Het maakt echt een verschil of jouw persona een schoolverlater is die net haar eerste zaak start, of een bankier wiens oudste zoon zojuist zijn MBA-diploma heeft gehaald, of een gegevensbeheerder in een ziekenhuis die haar tweede baby verwacht. Een community van gelijkgezinden is niet altijd een vereiste voor een succesvolle API, maar het intentioneel wegzetten van product – marktcombinaties is zeker noodzakelijk.

En zelfs als je jouw API aan je eigen collega’s wilt slijten, loont het zich om je voor een poosje in te denken hoe zij in het leven staan.

3. Wees slim

Je weet dat ontwikkelaars kritisch zijn als het gaat over hun applicaties. Ze kijken zorgvuldig naar de definities en als ze een mogelijke bottleneck zien, dan stuit je op weerstand. Dus, geef je getoonde resultaten niet zomaar met een ?offset={nr} parameter weg, omdat zij dit kunnen opvatten alsof het ten koste gaat van de prestaties en niet goed op kan schalen naar grotere aantallen resultaten. In plaats daarvan zou je ?start={ID} kunnen gebruiken, wat ook nog eens voorspellend werkt als iemand de URL opslaat of in de favorieten zet. Het zijn de details die ervoor zorgen dat alles er professioneel en betrouwbaar uitziet. En sowieso moet je tekst precies de juiste toon voor jouw publiek hebben.

4. Wees toegewijd

In alle gevallen zul je consistent moeten zijn tussen je API’s en vooral met verschillende methodes binnen je API. Je zult dus tijd moeten besteden aan het standaardiseren van objectdefinities en de notatie ervan. Voorkom verschillende RegEx’s voor dezelfde attributen in verschillende API’s. En een API mag op geen enkele manier laten zien hoe jouw applicaties, diensten en gegevens gestructureerd zijn.

Wees daarnaast ook zorgvuldig in hoe je omgaat met foutmeldingen. Schrijf zinvolle returncodes, met handige uitleg, zonder dat je informatie blootgeeft die beter niet in handen komt van iemand die kwaad wil. Wees niet zo knullig een HTTP 200 {Created} na een PUT-request terug te spelen, of een 405 {Not Acceptable}. Dat lijdt alleen tot verwarring.

Maateenheden

Meeteenheden zijn vaak een heikel punt. Als je van plan bent om zaken te doen buiten Europa, maak dan niet de fout specifieke formaten voor temperatuur, afstanden en volumes aan de wereld op te dringen. Dat zou niet heel beleefd zijn. Zie het onder ogen, jij bent de uitzondering hier, niet de standaard.
Het is niet heel moeilijk om met API-definities zorgzaamheid en robuustheid uit te drukken in plaats van willekeurigheid. Gebruik algemene uitdrukkingen, limieten en opsommingen in je API’s. Er ligt schoonheid in een goedgeschreven API-definitie. Voor de abonnees van je API wordt het gemakkelijker in gebruik en voor jouzelf is het handzamer beveiligen. Geen excuses dus.

5. Plan op de lange termijn

Een succesvolle API-strategie vraagt om toewijding voor een lange periode, waarbij interactie met ontwikkelaars gedurende de hele levensloop van je API’s belangrijk is. Zoals ieder onderdeel van het zakenleven: stop het niet aan het eind van de bedrijfsontwikkeling. Om echt succesvol te zijn zul je API-management als een onmisbare functie van je bedrijf moeten organiseren. Maak niet de vergissing te denken dat het uitrollen van de tool je blijvend succes op zal leveren. De tool is echt maar een tool. Dit geldt zowel bij het opstellen van een verdienmodel voor API’s als wanneer je ze als meerwaarde voor je diensten aanbiedt. Het geldt zelfs nog steeds als je jouw API’s alleen maar binnen je eigen organisatie inzet.

API-portfoliomanagement

Als je meer dan één API hebt zou je je voordeel kunnen doen met API-portfoliomanagement. Een API-portfoliomanager is verantwoordelijk voor het beheren van de API-backlog, het leveren van de API en het aansturen van de API-operations. Het is de persoon die het API-platform en de diensten die erop aangeboden worden in beheer heeft, iemand die de API-workflows bepaald en de betrokkenheid van API-ontwikkelaars stimuleert. In situaties waar er veel API’s beheerd worden, wordt de manager ondersteund door het API-portfoliomanagementteam dat optreedt als schakel tussen de API-ontwikkelaars en -gebruikers, de producenten en klanten. Normaliter begeleiden zij het ontwerp van nieuwe API’s, en garanderen ze dat het design en de regels voor naamgeving gehandhaafd worden. Als er een verdienmodel aan de API’s zit, zal de API-portfoliomanager de eerste zijn die voor de omzet aansprakelijk is.

Marktbenadering met een API

De API-portfoliomanager is voornamelijk verantwoordelijk voor de cohesie en consistentie van zijn portfolio. Een API-portfolio dient het resultaat te zijn van een API-marketbenadering, dat net zo goed als een productportfolio niet zonder strategie opgesteld wordt.

API-board en API-sponsor

De API-portfoliomanager brengt verslag uit aan het API-board. Dit is een orgaan dat besluiten kan nemen en gewoonlijk bestaat uit vertegenwoordigers vanuit marketing, sales, business development en operations. Dit is de plek waar het API-beleid opgesteld wordt en de prioriteiten voor de API-backlog bepaald worden. Tot slot zal er, omdat er een budget moet zijn om deze operatie draaiende te houden, een API-sponsor moeten zijn. Dit is de persoon die als ambassadeur voor API’s in het bestuur zit en de zakelijke meerwaarde duidelijk uit kan leggen om zo actieve betrokkenheid van hooggeplaatste vertegenwoordigers in het API-board kan verzekeren.

Hoe zat het ook alweer met die impulsieve koper? Nou, het zal zeker niet schaden om een gratis proefperiode in je prijsstelling op te nemen of een gratis basispakket van je dienst aan te bieden. Uiteindelijk verdient ‘gratis’ goed geld tegenwoordig.

Als je meer wil dan alleen dit gratis advies, dan ben je altijd van harte welkom. We zouden graag op de lange termijn met u in contact blijven.