💡 Tip: API-toegang is beschikbaar in het Pro pakket. Ontwikkelaars kunnen de API gebruiken voor integraties.
API sleutel aanmaken
Om de API te gebruiken heb je een API sleutel nodig:
- •Log in als Administrator
- •Ga naar "Instellingen" > "API & Integraties"
- •Klik op "Nieuwe API sleutel"
- •Geef de sleutel een beschrijvende naam
- •Kopieer de sleutel en bewaar deze veilig
⚠️ Belangrijk: De API sleutel wordt maar één keer getoond. Bewaar deze op een veilige locatie. Deel de sleutel nooit publiekelijk of in versiebeheer.
API documentatie
De volledige API documentatie is beschikbaar op:
- •docs.nova-solutions.nl/api
- •Interactieve API explorer
- •Code voorbeelden in meerdere talen
- •Webhooks documentatie
- •Rate limits en best practices
Authenticatie
De Nova API gebruikt Bearer token authenticatie. Voeg je API sleutel toe aan elke request:
- •HTTP Header: Authorization: Bearer {je-api-sleutel}
- •Alle endpoints vereisen een geldige API sleutel
- •Tokens verlopen niet tenzij je ze handmatig intrekt
Beschikbare endpoints
De API biedt toegang tot vrijwel alle Nova functionaliteit:
- •Klanten (GET, POST, PUT, DELETE)
- •Projecten en taken
- •Facturen en offertes
- •Tijdregistratie
- •Medewerkers
- •Documenten
- •Rapportages
Rate limits
Om de service stabiel te houden hanteren we rate limits:
- •Standard pakket: 100 requests per minuut
- •Pro pakket: 1000 requests per minuut
- •Bij overschrijding: HTTP 429 Too Many Requests
- •Rate limit info in response headers
💡 Tip: Implementeer retry logic met exponential backoff voor robuuste integraties.
Webhooks
In plaats van polling kun je webhooks gebruiken voor real-time notificaties:
- •Ontvang events wanneer er iets gebeurt in Nova
- •Configureer webhook URLs in de instellingen
- •Ondersteunde events: factuur betaald, nieuwe taak, project voltooid, etc.
- •Webhook signatures voor veiligheid
Veelvoorkomende use cases
Wat developers vaak met de API bouwen:
- •Automatisch facturen synchroniseren met boekhoudsoftware
- •Custom dashboards en rapportages
- •Tijdregistratie importeren uit andere systemen
- •Projecten aanmaken vanuit CRM
- •Mobiele apps voor specifieke workflows
Support voor developers
Hulp nodig bij het bouwen van een integratie?
- •Developer docs: docs.nova-solutions.nl
- •Support: api@nova-solutions.nl
- •GitHub examples repository
- •Community forum voor developers