Je datamodel opzetten
Begin met je databaseschema voordat je endpoints bouwt. Xano's visuele tabellenbuilder ondersteunt alle PostgreSQL-datatypes: tekst, gehele getallen, boolean, JSON, tijdstempels en bestandsreferenties.
Sleutelconventies die we gebruiken: elke tabel krijgt een created_at en updated_at tijdstempel (Xano voegt deze automatisch toe), gebruik integer ID's voor prestaties en gebruik JSON-velden spaarzaam — normaliseer waar mogelijk.
Voor multi-tenant SaaS moet elke tabel een user_id of workspace_id foreign key hebben. Dit houdt je toegangscontrole-logica schoon en consistent. In een typische Nederlandse B2B SaaS — zeg een HR-systeem of een inkooptool — betekent dit dat elke organisatie (klant) zijn geïsoleerde dataset heeft, wat een fundamentele AVG-vereiste is.
Je API-endpoints structureren
Xano genereert automatisch CRUD-endpoints voor elke tabel. Maar voor productie-apps wil je aangepaste endpoints die bedrijfslogica beheren.
Onze naamgevingsconventie: GET /api/[resource] (lijst), GET /api/[resource]/:id (detail), POST /api/[resource] (aanmaken), PATCH /api/[resource]/:id (bijwerken), DELETE /api/[resource]/:id (verwijderen). Houd het RESTful. Vermijd RPC-stijl endpoints tenzij de actie echt niet op een resource kan worden gemapt.
Een goed gestructureerd API-ontwerp zorgt ervoor dat je WeWeb-frontend of FlutterFlow-mobiele app verbinding kan maken met minimale configuratie — en als je uiteindelijk meer clients wilt verbinden (bijv. een externe integratie met een Nederlands ERP-systeem) is je API al klaar.
Authenticatie en autorisatie
Xano's ingebouwde auth is JWT-gebaseerd en productieklaar. Activeer de auth-extensie en je krijgt registratie, inloggen en token-vernieuwing direct out of the box.
Voor autorisatie (wat een ingelogde gebruiker kan doen) gebruik je de "Precondition"-stap in je function stacks. Een typisch patroon: haal de huidige gebruiker op uit de JWT, verifieer dan dat ze eigenaar zijn van het record dat ze proberen te wijzigen.
Voor beheerdersrollen sla je een rolveld op in de gebruikerstabel en controleer je dit in preconditions. Voor multi-tenant sla je workspace-lidmaatschap op in een aparte tabel en doe je een join bij elk verzoek. Xano's JWT-verwerking werkt naadloos met WeWeb's authenticatieplugin.
Bedrijfslogica met function stacks
Xano's function stack is waar de magie gebeurt. Elke stap in de stack komt overeen met een operatie: query een database, roep een extern API aan, voer een conditie uit, transformeer data, stuur een e-mail.
Voor complexe logica gebruik je Xano's "Custom Function"-functie om herbruikbare bouwstenen te maken. We bouwen deze voor: prijsberekening, validatie van complexe input, verzenden van meldingen en synchroniseren van data met derde partijen.
Vermijd diep geneste condities — als je stack meer dan 3 niveaus van nesting heeft, refactor naar afzonderlijke functies. Deze discipline houdt je Xano-instantie onderhoudbaar en overdraagbaar aan de klant of een nieuw team.
Derde partij-integraties
Xano's External API Request-stap verbindt met elk REST API. We hebben Stripe, Twilio, SendGrid, HubSpot, Airtable en tientallen anderen geïntegreerd.
Best practice: maak een "utility"-functie per externe dienst (bijv. "Stuur Stripe-betaling") die het API-aanroep, foutafhandeling en respons-parsing beheert. Roep dit dan aan vanuit je bedrijfslogica-stacks — het houdt je logica schoon en maakt de integratie eenvoudig bij te werken.
Voor Nederlandse SaaS-bedrijven zijn veelvoorkomende integraties: Mollie (betalingen), Exact Online (boekhouding), Twinfield, e-Herkenning, iDEAL via Mollie, en PostNord/DHL voor verzending. Xano's External API-stap verwerkt al deze zonder speciale code.
Prestaties en schaling
Xano schaalt automatisch — geen infrastructuurbeheer nodig. Voor prestatieoptimalisatie: gebruik indexen op velden die je vaak bevraagt (user_id, created_at, status), pagineer alle lijst-endpoints (gebruik Xano's ingebouwde offset/limit of cursor-paginering) en gebruik Xano's caching voor data die niet vaak verandert.
Voor verkeer-intensieve endpoints bieden Xano's betaalde plannen verhoogde concurrency. We hebben apps met 50.000 dagelijkse actieve gebruikers op Xano gedraaid zonder prestatieproblemen. Voor Nederlandse SaaS-bedrijven met groeiambities is dit een comfortabele marge — je kunt je concentreren op klantenwerving in plaats van infrastructuurafstelling. App Studio heeft 50+ apps in productie geleverd op deze stack.