API BCE sandbox: de API testen in je browser, zonder account
Sandbox van API BCE: verstuur echte verzoeken vanuit je browser met de demosleutel, fictieve testgegevens of je eigen sleutel, met antwoord en timing.
Wat je in de sandbox van API BCE kunt uitproberen#
De sandbox verstuurt echte verzoeken vanuit je browser. Je ziet dus het ruwe antwoord, de tijd en het resterende quotum. Dat maakt hem nuttig in verschillende fasen van een project, ook voor wie geen code schrijft.
- Verkenning: zien welke velden een ondernemingsfiche bevat, voordat je je datamodel ontwerpt.
- Demonstratie: een productmanager of klant tonen wat de API oplevert, zonder installatie.
- Foutopsporing: een verzoek uit je code nabootsen om te zien of het probleem bij de invoer ligt.
- Randgevallen: met testgegevens een faillissement of een overschreden quotum bekijken.
De drie modi verstandig kiezen#
De demosleutel werkt zonder inschrijving. Hij is echter gedeeld en beperkt tot 15 verzoeken per 10 minuten, met alleen publieke registergegevens. Hij is dus ideaal voor een eerste kennismaking, maar niet voor intensief testen.
De modus met testgegevens gebruikt de fictieve ondernemingen van de test-API. Probeer bijvoorbeeld 0999.999.229 voor een faillissement of 0999.999.526 voor een overschreden quotum. Zo zie je precies hoe een foutantwoord eruitziet, voordat je je foutafhandeling schrijft.
Met je eigen sleutel ten slotte test je met je echte formule. Je sleutel en secret blijven in het tabblad (sessionStorage) en worden alleen voor dat verzoek doorgestuurd. Toch blijft het verstandig om een aparte sleutel te gebruiken voor experimenten. Bovendien tellen deze verzoeken mee voor je quotum.
Van sandbox naar code#
Werkt een verzoek in de sandbox, neem dan dezelfde parameters over in je code. Vergelijk daarna het antwoord van je code met dat van de sandbox. Zijn ze verschillend, dan ligt het probleem meestal bij de headers of de URL. Kopieer ten slotte nooit je secret naar een gedeeld document of chatbericht. De kant-en-klare codefragmenten vind je op de pagina Voorbeelden.
Gebruik de sandbox ook bij support. Krijgt een collega een vreemd resultaat, laat hem dan hetzelfde nummer in de sandbox proberen. Zo zie je meteen of het antwoord van API BCE afwijkt, of dat je eigen verwerking het probleem veroorzaakt.
Veelgestelde vragen over API BCE en de sandbox#
Heb ik een account nodig voor de sandbox?
Nee. Met de demosleutel test je zonder account, binnen een limiet van 15 verzoeken per 10 minuten.
Wordt mijn secret ergens opgeslagen?
Nee. Je sleutel en secret blijven in het tabblad en worden alleen voor het verzoek naar de API doorgestuurd. Ze worden nooit aan onze kant bewaard.
Waarom werkt een endpoint niet met de demosleutel?
Sommige endpoints vragen je eigen sleutel. De sandbox toont dat dan met een melding. Maak in dat geval gratis een sleutel aan.