← Blog
🔌 Großhandels-API

Starte deine eigene Versandmarke
ohne eine einzige Carrier-Integration zu bauen.

Die Anbindung an UPS, DHL, InPost, Correos, Poste Italiane, DPD, GLS und SEUR bedeutet normalerweise wochenlange Verträge, Geschäftskonten und APIs, die sich jedes Quartal ändern. Die Großhandels-API von NullShip packt all das hinter einen einzigen Token: Du verkaufst Labels an deine eigenen Kunden zu deinem Preis, und wir kümmern uns um die Technik mit den Carriern. Eine REST-API, durchgehend JSON, über Tor — du setzt deinen Aufschlag, behältst die Marge und kassierst in Krypto.

1. Das Problem: Versandlabels weiterzuverkaufen ist teuer zu bauen

Jeder Carrier hat sein eigenes Onboarding, sein eigenes Label-Format und seine eigene Vorstellung davon, was eine gültige Postleitzahl ist. Multipliziere das mit Dutzenden Diensten und 30 Ländern und du hast ein monatelanges Projekt, bevor du dein erstes Label verkaufst — plus endlose Wartung, sobald einer von ihnen etwas ändert.

Die übliche Alternative ist der Weiterverkauf von Hand: Bestellung im Chat annehmen, selbst bezahlen, PDF weiterleiten. Das skaliert nicht und lässt dich ohne konsistente Preise und ohne Buchhaltung zurück.

2. Was es ist: eine Großhandelsschicht, bereit zum Weiterverkauf

POST /api/v1/rates liefert Echtzeit-Tarife; POST /api/v1/labels erzeugt das echte Label und gibt dir das PDF. Darunter wählt unsere Routing-Schicht die beste Quelle für jeden Korridor und liefert sie sofort — diese Logik gehört uns und du siehst sie nie. Du sprichst mit einem einzigen Endpunkt und bekommst immer den richtigen Tarif, ohne Verträge oder Integrationen zu pflegen.

curl -x socks5h://127.0.0.1:9050 \
  -H "Authorization: Bearer nsk_test_…" \
  -H "Content-Type: application/json" \
  -d '{ "from": {…}, "to": {…}, "parcel": {"weight": 2, "length": 30, "width": 20, "height": 10} }' \
  http://nshipaklqgackrcrezr4lum3msy4wfdlnmmb6wzzbuy7onbjnmckbxad.onion/api/v1/rates

Echtzeit-Tarife für einen Korridor — derselbe Aufruf funktioniert in Sandbox oder Produktion.

3. Unterkonten: deine Kunden, deine Marke

Das Herz des Reseller-Modells. Du legst Unterkonten für deine eigenen Kunden an — jedes mit eigenem Guthaben, eigener Label-Historie und eigenem Login. Jeder Aufruf, den du in ihrem Namen machst, trägt eine X-Sub-Account-Id, sodass das System jeden Kostenpunkt und jede Marge automatisch der richtigen Partei zuordnet.

POST /api/v1/sub-accounts — einen Kunden anlegen
GET /api/v1/sub-accounts/me/labels — der Kunde sieht seine Sendungen
POST /api/v1/sub-accounts/me/topup — der Kunde lädt Guthaben auf (Krypto-Rechnung) oder löst einen Prepaid-Code ein

Baue dein eigenes Frontend mit signup-token → register → auth, oder spare dir die Entwicklung und nutze unseren Web-Assistenten, den Telegram-Bot oder die Mini-App — gemacht für Reseller, die nicht programmieren wollen.

4. Du setzt den Preis, du behältst die Marge

Du legst deinen Aufschlag fest — global oder pro Land-zu-Land-Korridor. Jedes Label, das einer deiner Kunden kauft, erzeugt einen Gewinn, der sich in deinem Provisionszyklus ansammelt. Zum Abschluss zahlst du ihn aus: in Krypto (BTC / LTC / XMR) oder auf das Guthaben eines anderen Kontos. Das Dashboard zeigt dir jede Bewegung, welche Unterkonten gerade online sind und die Gewinnaufschlüsselung pro Verkauf.

🔒 5. Privat von Haus aus

NullShip ist onion-only by design: Die API läuft auf einem .onion-Dienst, mit Bearer-Token-Authentifizierung und Schlüsseln, die nur einmal angezeigt werden (wir speichern nur den Hash). Zahlungen und Auszahlungen in Krypto. Kein JavaScript erforderlich — es funktioniert sogar mit Tor auf der höchsten Sicherheitsstufe.

6. Teste, bevor du einen Cent ausgibst

Jeder Partner bekommt zwei Schlüssel: nsk_test_* (Sandbox) und nsk_live_* (Produktion). In der Sandbox liefert /rates echte Daten und /labels gibt dir ein synthetisches Label mit Fake-Tracking — keine Guthabenbewegung. Baue und teste deine gesamte Integration, und wenn sie bereit ist, wechselst du den Schlüssel. Das war es.

Häufige Fragen

Wie bekomme ich Zugang? +
Der Zugang erfolgt auf Einladung, Konto für Konto. Du eröffnest ein normales NullShip-Konto, kontaktierst uns per Ticket oder PGP und beschreibst, was du bauen willst, machst eine erste Aufladung, und der Betreiber schaltet die API frei und erzeugt dein Schlüsselpaar — Sandbox und Produktion —, das du nur einmal siehst, bei der Erstellung.
Was kostet die API? +
Nichts zusätzlich zu den Labels. Du zahlst den Versand; die Großhandelsschicht ist kostenlos. Deinen Aufschlag setzt du selbst, und er gehört dir.
Welche Länder und Carrier deckt sie ab? +
Die wichtigsten Netze in Europa (ES, IT, NL, DE, FR und über 30 EU-Ziele): UPS, DHL, DPD, GLS, InPost, BRT, Correos, SEUR, Poste Italiane und mehr, je nach Korridor.
Muss ich programmieren? +
Nicht unbedingt. Wenn du willst, integrierst du die REST-API. Wenn nicht, nutzt du den Web-Assistenten, den Telegram-Bot oder die Mini-App und verkaufst weiter, ohne eine Zeile Code zu schreiben.
Wie werde ich bezahlt? +
In jedem Zyklus zahlst du deine angesammelte Marge in BTC, LTC oder XMR aus oder verschiebst sie auf das Guthaben eines anderen Kontos. Alles wird im Bewegungs-Ledger des Dashboards erfasst.

Bereit, unter deiner eigenen Marke weiterzuverkaufen?

Der Zugang erfolgt auf Einladung. Eröffne ein Konto, öffne ein Ticket (oder erreiche uns per PGP) und erzähl uns, was du bauen willst — wir schalten Sandbox und Produktion frei.

Konto erstellen →