Om de Soldo Business API te gebruiken in je productieaccount, moet je een toepassing aanmaken in de Soldo webapp. Dit proces genereert de inloggegevens die je systeem gebruikt om veilig te authenticeren met de API.
Maak een toepassing aan
- Log in op de Soldo webapp.
- Ga vanuit het hoofdmenu naar Integraties > Business API.
- Selecteer Toepassing aanmaken.
- Voer een naam in voor je toepassing.
- Voer een publieke sleutel in. Je moet een geldig RSA 2048-bits sleutelpaar in PEM-indeling genereren.
Wat is een sleutelpaar?
- Publieke sleutel: Wordt gedeeld met Soldo. Zie het als een gebruikersnaam — het identificeert je toepassing.
- Private sleutel: Wordt geheim gehouden. Deze wordt gebruikt om je API-verzoeken veilig te ondertekenen.
Je vindt instructies voor het aanmaken van een sleutelpaar met openssl tijdens het instelproces.
- Selecteer Volgende.
- Selecteer de scopes die je toepassing nodig heeft en klik vervolgens op Doorgaan. Je kunt deze later indien nodig aanpassen.
- Controleer je instellingen en accepteer de algemene voorwaarden.
- Selecteer Toepassing aanmaken
Na het aanmaken worden je inloggegevens getoond in een pop-up:
- Client ID – identificeert je toepassing
- Client secret – wordt gebruikt voor standaard authenticatie
- Fingerprint-token – wordt gebruikt voor geavanceerde authenticatie of het downloaden van bijlagen
Wat als ik mijn API-inloggegevens kwijt ben?
Je kunt ze op elk moment opnieuw genereren. Ga naar Integraties > Business API, selecteer de toepassing en klik op Inloggegevens opnieuw genereren. Hiermee wordt een nieuwe Client secret en Fingerprint-token gegenereerd. Je Client ID blijft hetzelfde.
Volgende stappen
Zodra je je toepassing in de webapp hebt aangemaakt en je inloggegevens hebt gegenereerd, ben je klaar om aan de slag te gaan met de Soldo Business API.
De volledige API-documentatie is te vinden in ons Business API Developer Portal.