Wat doet de API voor Van Colen Potatoes?
De API vormt een gecontroleerde verbinding tussen het bestaande ERP-systeem en een externe bestelapp. Via deze koppeling kan de bestelapp gegevens opvragen uit het ERP-systeem en bestellingen doorgeven aan de bestelapp, zonder rechtstreeks toegang te krijgen tot de onderliggende database.
De API biedt onder andere volgende mogelijkheden:
- Klanten opzoeken: klantgegevens, facturatieadressen en verschillende vestigingen raadplegen.
- Producten raadplegen: artikelen opzoeken en filteren, inclusief productinformatie en meertalige benamingen.
- Bestellingen aanmaken: nieuwe bestellingen doorsturen met producten, aantallen, gewenste leverdatum en eventuele opmerkingen.
- Bestellingen beheren: bestaande bestellingen raadplegen, aanpassen of verwijderen.
- Klantgebonden informatie ophalen: onder andere vaste bestelproducten en de beschikbare besteldagen per vestiging.
Dankzij deze API hoeft de externe ontwikkelaar de complexe structuur van het ERP-systeem niet te kennen. De bestelapp communiceert via duidelijk omschreven functies met de bestaande software.
Veiligheid is geen bijzaak bij API-ontwikkeling
Bij de ontwikkeling voor Van Colen Potatoes hebben we veel aandacht besteed aan beveiligde authenticatie en gecontroleerde gegevensuitwisseling.
De API werkt met JWT-tokens (JSON Web Tokens). De bestelapp moet zich eerst aanmelden achter de schermen en ontvangt vervolgens een token met een beperkte geldigheidsduur. Dat token wordt gebruikt bij de communicatie met de API.
Daarnaast zijn de beschikbare functies duidelijk afgebakend. De externe toepassing communiceert via vooraf gedefinieerde toegangspunten, in plaats van rechtstreeks met de database te werken.
Ook de gegevens die naar de API gestuurd worden, moeten aan bepaalde voorwaarden voldoen. Zo worden onder andere verplichte velden, toegelaten waarden en gegevensformaten allemaal gecontroleerd.
Een professioneel ontwikkelde API is dus meer dan een technische verbinding. Ze vormt ook een belangrijke beveiligingslaag tussen je bedrijfssoftware en de buitenwereld.
Duidelijke documentatie voor externe ontwikkelaars
Een API is pas echt bruikbaar wanneer andere ontwikkelaars er vlot mee aan de slag kunnen.
Daarom hebben we de API van Van Colen Potatoes opgebouwd volgens de OpenAPI-standaard. Deze beschrijft welke functies beschikbaar zijn, welke gegevens verwacht worden en welke antwoorden de API teruggeeft.
Dat biedt belangrijke voordelen:
- Externe ontwikkelaars kunnen sneller starten met de integratie.
- Er is minder overleg nodig over de technische werking.
- De afspraken over gegevensuitwisseling liggen duidelijk vast.
- De koppeling kan eenvoudiger getest, onderhouden en verder uitgebreid worden.
Dit is vooral belangrijk wanneer verschillende softwareleveranciers samenwerken. Een goed gedocumenteerde API maakt hen minder afhankelijk van elkaars interne technologie.
Je bestaande software behouden en toch nieuwe mogelijkheden creëren
Een belangrijke meerwaarde van API's is dat bedrijven niet telkens hun volledige softwareomgeving moeten vervangen wanneer ze nieuwe toepassingen willen inzetten.
Bij Van Colen Potatoes blijft het bestaande ERP-systeem de centrale plaats waar bedrijfsgegevens en bestellingen beheerd worden. Via de API kan een afzonderlijke bestelapp daar veilig op aansluiten.
Dat biedt flexibiliteit. Een bedrijf kan bijvoorbeeld een nieuwe mobiele app laten ontwikkelen, een klantenportaal toevoegen of in de toekomst andere software koppelen, zonder dat de volledige achterliggende toepassing opnieuw gebouwd moet worden.