API BCE Sandbox: Anfragen im Browser ohne Anmeldung testen
Sandbox der API BCE: Senden Sie echte Anfragen aus dem Browser mit dem Demo-Schlüssel, fiktiven Testdaten oder Ihrem eigenen Schlüssel.
Den Playground der API BCE gezielt einsetzen#
Der Playground beantwortet schnelle Fragen ohne eine Zeile Code. Welche Felder liefert ein Endpunkt? Wie sieht ein Fehler aus? Passt der Endpunkt zu meinem Anwendungsfall? Zum Beispiel prüft ein Produktteam dort, ob /search/address die gewünschten Treffer liefert. Erst danach beginnt die Entwicklung.
Die drei Modi im Vergleich#
- Demo-Schlüssel: ohne Anmeldung, 15 Anfragen alle 10 Minuten, nur öffentliche Registerdaten.
- Testdaten: fiktive Unternehmen der Test-API, ideal für Fehlerfälle wie 429 oder Konkurs.
- Eigener Schlüssel: alle Endpunkte Ihres Tarifs mit echten Daten.
Wählen Sie den Modus nach Ihrer Frage. Für einen ersten Eindruck genügt der Demo-Schlüssel. Wollen Sie dagegen Fehlerbehandlung verstehen, nutzen Sie die Testdaten. Probieren Sie zum Beispiel 0999.999.229 für einen Konkurs oder 0999.999.526 für ein überschrittenes Kontingent. Brauchen Sie schließlich Jahresabschlüsse oder Organe, wählen Sie Ihren eigenen Schlüssel.
Sicherheit und Grenzen#
Ihr Schlüssel und Ihr Secret bleiben im Browser-Tab, im sessionStorage. Sie gehen nur für die jeweilige Anfrage an die API und werden nicht gespeichert. Nutzen Sie den Playground trotzdem nicht auf fremden Rechnern. Schließen Sie außerdem den Tab nach der Sitzung. Beachten Sie zudem: Aufrufe mit eigenem Live-Schlüssel zählen zu Ihrem Kontingent.
Der Playground ersetzt keine Integrationstests. Übertragen Sie gefundene Aufrufe deshalb in Ihren Code und testen Sie sie dort gegen den Testmodus.
Den Playground im Team nutzen
Der Playground eignet sich auch für Gespräche mit Fachabteilungen. Zeigen Sie zum Beispiel der Buchhaltung, welche Felder ein Unternehmensdatensatz enthält. Danach entscheiden Sie gemeinsam, welche Felder ins CRM gehören. Ebenso hilft er bei der Fehlersuche: Antwortet Ihr Code anders als der Playground, liegt das Problem meist in Ihren Headern oder in der URL-Kodierung.
Nutzen Sie dafür jedoch die Testdaten, sobald Sie Fehlerfälle vorführen.
Halten Sie außerdem fest, welche Aufrufe Sie im Playground geprüft haben. Eine kurze Liste mit Endpunkt, Parametern und Ergebnis genügt. Sie dient später als Vorlage für Ihre automatisierten Tests. So geht kein Erkenntnisgewinn verloren, wenn Sie den Tab schließen.
Zuletzt ein praktischer Hinweis: Kopieren Sie Antworten aus dem Playground direkt in Ihre Testdaten. So arbeiten Sie mit realistischen Beispielen.
Häufige Fragen zum Playground der API BCE#
Warum meldet der Playground der API BCE eine Wartezeit?
Der Demo-Schlüssel ist geteilt und auf 15 Anfragen alle 10 Minuten begrenzt. Warten Sie die genannte Zeit ab oder nutzen Sie Ihren eigenen Schlüssel.
Warum funktioniert ein Endpunkt nur mit eigenem Schlüssel?
Der Demo-Schlüssel liefert nur öffentliche Registerdaten. Manche Endpunkte erfordern daher Ihren eigenen Schlüssel und einen passenden Tarif.
Sendet der Playground echte Anfragen?
Ja. Er ruft die Live-v2-API oder die Test-API auf. Die Antworten sind also identisch mit denen in Ihrem Code.