Een API-sleutel aanmaken
Voor je een koppeling kan bouwen, heb je een API-sleutel nodig. Die maak je zelf aan in je account.
Een sleutel aanmaken
Ga in je EenvoudigFactureren-account naar Toegangsbeheer.
Klik op API-sleutel toevoegen.
Geef de sleutel een naam die zegt waarvoor ze dient, bijvoorbeeld Webshop, CRM of Boekhoudpakket. Zo weet je later welke sleutel je zonder risico kan intrekken.
Bewaar de sleutel op een veilige plaats en geef ze door aan wie de koppeling bouwt.
Het adres van de API
Alle verzoeken voor EenvoudigFactureren vertrekken naar:
https://eenvoudigfactureren.be/api
Werk je met een SimplyBooks-account? Dan gebruik je:
https://app.simplybooks.be/api
Eén sleutel per koppeling
Maak een aparte sleutel per toepassing. Gaat er ergens iets mis, dan trek je die ene sleutel in zonder de rest plat te leggen.
Zet een sleutel nooit in code die in de browser van je bezoekers terechtkomt. Wie de pagina bekijkt, kan de sleutel dan meelezen.
Werk je niet langer met een leverancier? Trek zijn sleutel dan meteen in.
Meerdere klanten bedienen
Bouw je software die bij verschillende EenvoudigFactureren-klanten draait? Werk dan niet met vaste sleutels, maar met OAuth. Elke klant geeft zelf toegang en kan die toegang ook zelf weer intrekken.
De volledige uitwerking vind je in de API-documentatie.
Daar lees je ook:
hoe je de sleutel meestuurt;
welke foutmeldingen je kan krijgen;
hoe je zoekt, filtert en sorteert.