API-ontwikkeling of API-integratie: wat bestel je?
Bij integratie koppel je je website of software aan een API die al bestaat, zoals die van Stripe, Shopify of Mailchimp. Dat komt het vaakst voor: het werk bestaat uit aansluiten, testen en fouten afhandelen.
Bij ontwikkeling wordt een nieuwe API gebouwd, zodat een mobiele app, een partner of andere software bij je gegevens kan. Daar komen het ontwerp van de toegang, het schrijven van documentatie en het beheer van versies bij. Twijfel je, beschrijf dan de twee tools die met elkaar moeten praten en het gewenste resultaat: de ontwikkelaar helpt je kiezen, ook tussen REST en GraphQL.
Wat kost een API-koppeling of API-ontwikkeling door een freelancer?
Reken op € 100 tot € 2.000, voor 3 tot 15 werkdagen. Aan de onderkant zit het koppelen van een goed gedocumenteerde dienst aan één tool. Bovenaan zit een synchronisatie in twee richtingen, of een kleine API met authenticatie en documentatie.
Een project dat meerdere systemen of grote volumes raakt, valt buiten dat kader: laat het na een gesprek doorrekenen. Abonnementen en gebruikskosten van de gekoppelde dienst komen er los bij.
Waar vind je een freelance API-ontwikkelaar of integratiespecialist?
Op BeFreelancr bieden ontwikkelaars deze diensten aan met een vaste prijs en levertijd, en je kunt ze een bericht sturen voordat je bestelt. Waar je ook zoekt: kies iemand met ervaring met de API in kwestie. Wie Stripe goed kent, weet daarmee nog niets van de eigenaardigheden van PayPal of een ERP-systeem.
Vraag naar een vergelijkbaar voorbeeld en naar de manier waarop fouten worden afgehandeld. Laat je voor het ontwerp van een API ook een stuk documentatie zien dat de ontwikkelaar eerder schreef.
Gecodeerde API of no-codetool: wat kies je om je software te koppelen?
Make, Zapier of n8n volstaan vaak voor eenvoudige uitwisselingen die niet te vaak voorkomen, en je team kan ze zelf nalopen. Code is eerder zinvol bij grote volumes, logica die eigen is aan je bedrijf, gevoelige gegevens of een functie die de kern van je website vormt.
Vergelijk drie posten: de opzet, de maandelijkse gebruikskosten en het oplossen van storingen. Een workflowautomatisering is in het begin goedkoper, maar de rekening groeit mee met je volumes.
Wat bereid je voor voordat je een API aan je tools laat koppelen?
- De link naar de API-documentatie en je abonnement, dat sommige aanroepen kan beperken.
- Een testomgeving of testsleutels, als de dienst die aanbiedt.
- Een paar concrete situaties: wat de uitwisseling in gang zet, en het verwachte resultaat.
- De hoeveelheid gegevens, per dag en op piekmomenten.
- Toegang met beperkte rechten. Stripe raadt bijvoorbeeld beperkte sleutels aan, gedeeld via een tool voor geheimenbeheer in plaats van per e-mail of chat.
Hoe controleer je de beveiliging van een API die aan je gegevens hangt?
- De rechten op elk gegeven. Ingelogd met één account wijzig je een id in de aanroep: er mogen geen gegevens van een ander account verschijnen. Dat is het eerste risico in de OWASP-ranglijst voor API's, editie 2023.
- De geheime sleutels. Die blijven op de server, buiten de broncode en de mobiele app.
- De webhooks. Hun handtekening wordt gecontroleerd, zodat valse berichten worden geweigerd.
- Het aantal aanroepen. Een limiet voorkomt storingen en een rekening die uit de hand loopt.
- De antwoorden van externe diensten. Die worden gecontroleerd zoals alle ontvangen gegevens.
Wie onderhoudt een API-koppeling na de oplevering?
Spreek dat af bij de bestelling, want een API verandert zonder jou iets te vragen. Shopify brengt bijvoorbeeld elk kwartaal een versie uit en ondersteunt elke versie minstens 12 maanden. Een koppeling die vandaag werkt, moet dus regelmatig worden nagelopen.
Vraag om een log van de aanroepen, een melding bij een mislukte uitwisseling en documentatie waarmee een andere ontwikkelaar het werk kan overnemen. Het onderhoud kan daarna via website-onderhoud of een losse bugfix, voor € 30 tot € 300.