Aus dem Englischen übersetzt. Bei Abweichungen gilt die englische Seite. Auf Englisch lesen
Integration testen
Zwei Wege zu testen, ohne jemanden zu beeinträchtigen: Testschlüssel, um einzelne Requests zu prüfen, und eine Sandbox, um deine gesamte Integration echt auszuführen, ohne dass etwas abgerechnet wird.
Es gibt zwei Wege zu testen, und sie beantworten unterschiedliche Fragen:
- Testschlüssel beantworten „Ist dieser Request richtig?“ Jeder Aufruf wird geprüft und simuliert, nichts wird gespeichert.
- Die Sandbox (für Partner) beantwortet „Funktioniert meine gesamte Integration?“ Alles passiert echt, mit echten Unternehmen, Kanälen, Webhooks und Bestellungen, aber nichts wird abgerechnet.
Die meisten Integrationen nutzen beides: Testschlüssel beim Schreiben jedes Aufrufs, die Sandbox, um den gesamten Ablauf von Anfang bis Ende durchzuspielen, bevor es live geht.
Auf einen Blick
Testschlüssel (nbl_test_…) | Sandbox-Partner (Live-Schlüssel) | |
|---|---|---|
| Wer | Alle | Partner (accounts:manage) |
| Requests werden validiert | Ja, genau wie live | Ja, es ist live |
| Daten werden gespeichert | Nein. Ein Produkt, das du „erstellst“, lässt sich nicht zurücklesen | Ja |
| Kanäle (Shopify, eBay…) | Nie berührt; Ergebnisse als "simulated" gekennzeichnet | Werden wirklich aktualisiert. Verbinde Test-Shops |
| Webhooks und Events | Keine | Ja, wie live (account_id bei jedem Event eines Unternehmens) |
Unternehmen (POST /accounts) | Simuliert (acct_test, "simulated": true). Du kannst nicht darin arbeiten | Echt, höchstens 3 gleichzeitig offen |
| Abrechnung | Nie | Nie. Die Abrechnung zeigt 0 und sandbox: true |
| Livegang | Wechsle zu deinem nbl_live_-Schlüssel | Live gehen im Dashboard; derselbe Schlüssel, dieselben Unternehmen |
Testschlüssel
Erstelle einen unter Einstellungen → Entwickler (Modus Test). Verwende ihn genau wie einen Live-Schlüssel:
curl -X POST https://api.nembol.com/rest/v1/products \
-H "Authorization: Bearer nbl_test_xxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"title": "Test mug", "variants": [{"sku": "MUG-1", "price": "12.00", "quantity": 5}]}'Die Antwort hat die Struktur, die ein Live-Aufruf zurückgeben würde, mit "simulated": true.
Fehler sind echt: Ein fehlendes Feld, ein falsches Preisformat oder eine fehlende
Berechtigung antworten genau wie live.
Was ein Testschlüssel nicht tut:
- Nichts wird gespeichert. Lesende Aufrufe geben die echten Daten deines Shops zurück, ein
simuliertes Produkt erscheint also nie in
GET /products. Teste jeden Schreibvorgang für sich; verkette nicht „erstellen, dann zurücklesen“. - Kein Kanal wird kontaktiert, keine Bestellung wird versendet, keine E-Mail wird verschickt.
- Keine Events oder Webhooks werden durch simulierte Aufrufe erzeugt.
Sandbox (Partner)
Die Sandbox ist dein Partnerkonto mit ausgeschalteter Abrechnung. Alles funktioniert wie live (darum geht es), sodass du die gesamte Integration bauen und ihr bei der Arbeit zusehen kannst:
- Dein Partnerkonto startet in der Sandbox: Nembol aktiviert es
so. Prüfe es mit
GET /partner/billing, das"sandbox": trueund"sandbox_max_accounts": 3zurückgibt. - Erstelle bis zu 3 Unternehmen mit
POST /accounts. Ein 4. offenes Unternehmen antwortet mit409 sandbox_limit. Schließe eines (POST /accounts/{id}/close), um einen Platz freizumachen. - Verbinde Test-Shops, keine echten Shops: einen Shopify-Entwicklungsshop, ein eBay- oder Etsy-Testkonto, eine WooCommerce-Website, die dir gehört. Angebote, Bestände und Bestellungen erreichen sie wirklich. Marktplätze mit Käufern (Amazon, TikTok Shop) sind echte Marktplätze, veröffentliche dort also mit Bedacht und delist deine Angebote wieder, wenn du fertig bist.
- Empfange Webhooks und frage ab genau wie in Produktion: Die Events jedes Unternehmens
erreichen deine Endpoints mit
account_id. - Prüfe die Abrechnung:
GET /partner/statementlistet deine Unternehmen mit Betrag 0 und"sandbox": true.
Live gehen
Wenn deine Integration bereit ist, schaltest du sie selbst im Dashboard live: Einstellungen → Partner → Live gehen (im Sandbox-Hinweis).
- Bei Kartenzahlung zuerst eine Karte hinzufügen. Nembol öffnet eine sichere Stripe-Seite, die die Karte speichert und nichts belastet.
- Bestätigen. Das Fenster zeigt, wie viele Unternehmen offen sind und was sie pro Monat zu deinen Konditionen kosten. Die Abrechnung beginnt an diesem Tag, tagesgenau anteilig.
GET /partner/billingantwortet danach mit"sandbox": false.
Dein Schlüssel, deine Unternehmen, ihre Kanäle und deine Webhooks bleiben genau so, wie sie sind, ohne Migration. Schließe Testunternehmen, die nicht abgerechnet werden sollen, bevor du live gehst.
Der Livegang ist eine Einbahnstraße: Ein Zurückschalten würde die Abrechnung live laufender Unternehmen stoppen. Um in die Sandbox zurückzukehren, schreib deshalb an developer@nembol.com. Über die API ist das bewusst nicht möglich: Die Abrechnung startet nie versehentlich durch ein Skript.
Was wann
- Einen neuen Aufruf oder einen neuen Fehlerzweig schreiben → Testschlüssel.
- Prüfen, ob ein Webhook-Handler, der Verbindungsablauf (Rückkehr-Link), das Abfragen von Bestellungen und die Abwicklung zusammen funktionieren → Sandbox.
- Eine reine Händler-Integration (ohne Partnerprogramm) → Testschlüssel, dann ein Live-Schlüssel auf einem Test-Shop, der mit deinem eigenen Nembol-Shop verbunden ist.
Zuletzt aktualisiert am 20. Oktober 2026
Brauchst du Hilfe?
Schreib uns, und ein Mensch antwortet, meist innerhalb eines Werktags.