Authentifizierung
Jede Anfrage an die FireAPI wird über einen API-Key authentifiziert. Der Key wird im
X-FIRE-APIKEY-Header
übergeben. Live- und Sandbox-Umgebung verwenden separate Keys, sodass sich Tests sauber von Produktivanfragen trennen lassen.
Setup in vier Schritten
API-Keys erhalten
Live- und Sandbox-API-Keys werden nach Abschluss des Onboardings automatisch bereitgestellt. Die Zugangsdaten erhältst du direkt per E-Mail.
Header bei jeder Anfrage setzen
X-FIRE-APIKEY: dein-geheimer-key
Bei fehlendem oder ungültigem Header antwortet der Server mit
401 Unauthorized.
Umgebung wählen
https://live.fireapi.de
Produktivsystem. Aktionen werden tatsächlich ausgeführt und gegebenenfalls abgerechnet.
https://sandbox.fireapi.de
Testumgebung mit identischem Verhalten. Antworten sind realistisch, es entstehen keine Kosten. Nicht alle Endpunkte sind in der Sandbox abgebildet.
Beispielaufruf
curl -X GET 'https://sandbox.fireapi.de/vm/list' \ -H 'X-FIRE-APIKEY: dein-sandbox-key'