← Blog
🔌 API hurtowe

Uruchom własną markę wysyłkową
bez budowania ani jednej integracji z przewoźnikiem.

Podłączenie do UPS, DHL, InPost, Correos, Poste Italiane, DPD, GLS i SEUR oznacza zwykle tygodnie umów, kont biznesowych i API, które zmieniają się co kwartał. Hurtowe API NullShip chowa to wszystko za jednym tokenem: sprzedajesz etykiety własnym klientom po swojej cenie, a my zajmujemy się hydrauliką po stronie przewoźników. Jedno API REST, JSON od początku do końca, przez Tor — ustawiasz marżę, zatrzymujesz zysk i wypłacasz w krypto.

1. Problem: odsprzedaż etykiet wysyłkowych jest droga w budowie

Każdy przewoźnik ma własny onboarding, własny format etykiety i własne pojęcie o tym, czym jest poprawny kod pocztowy. Pomnóż to przez dziesiątki usług i 30 krajów, a masz projekt na miesiące, zanim sprzedasz pierwszą etykietę — plus niekończące się utrzymanie za każdym razem, gdy któryś z nich coś zmieni.

Zwykła alternatywa to odsprzedaż ręczna: przyjmij zamówienie na czacie, zapłać za nie sam, prześlij PDF. To się nie skaluje i zostawia Cię bez spójnych cen i bez księgowości.

2. Czym jest: warstwa hurtowa gotowa do odsprzedaży

POST /api/v1/rates zwraca stawki na żywo; POST /api/v1/labels generuje prawdziwą etykietę i daje Ci PDF. Pod spodem nasza warstwa routingu wybiera najlepsze źródło dla każdego korytarza i podaje je natychmiast — ta logika jest nasza i nigdy jej nie widzisz. Rozmawiasz z jednym endpointem i zawsze dostajesz właściwą stawkę, bez umów i integracji do utrzymywania.

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

Stawki na żywo dla korytarza — to samo wywołanie działa w sandboksie lub na produkcji.

3. Subkonta: Twoi klienci, Twoja marka

Serce modelu resellerskiego. Tworzysz subkonta dla własnych klientów — każde z własnym saldem, własną historią etykiet i własnym loginem. Każde wywołanie, które wykonujesz w ich imieniu, niesie X-Sub-Account-Id, więc system automatycznie przypisuje każdy koszt i każdą marżę właściwej stronie.

POST /api/v1/sub-accounts — rejestrujesz klienta
GET /api/v1/sub-accounts/me/labels — klient sprawdza swoje przesyłki
POST /api/v1/sub-accounts/me/topup — klient doładowuje saldo (faktura krypto) lub realizuje kod przedpłacony

Zbuduj własny front-end z signup-token → register → auth, albo daruj sobie programowanie i użyj naszego kreatora webowego, bota Telegram lub mini-aplikacji — stworzonych dla resellerów, którzy nie chcą programować.

4. Ty ustalasz cenę, Ty zatrzymujesz marżę

Definiujesz swoją marżę — globalnie lub per korytarz kraj-kraj. Każda etykieta, którą kupi Twój klient, generuje zysk, który gromadzi się w Twoim cyklu prowizji. Na koniec go wypłacasz: w krypto (BTC / LTC / XMR) lub przeniesiony na saldo innego konta. Panel pokazuje każdy ruch, które subkonta są online na żywo oraz rozbicie zysku na sprzedaż.

🔒 5. Prywatność z założenia

NullShip jest onion-only z założenia: API działa na usłudze .onion, z uwierzytelnianiem tokenem bearer i kluczami pokazywanymi tylko raz (przechowujemy wyłącznie hash). Płatności i wypłaty w krypto. Bez wymaganego JavaScriptu — działa nawet z Torem na najwyższym poziomie bezpieczeństwa.

6. Testuj, zanim wydasz grosz

Każdy partner dostaje dwa klucze: nsk_test_* (sandbox) i nsk_live_* (produkcja). W sandboksie /rates zwraca prawdziwe dane, a /labels daje syntetyczną etykietę z fałszywym śledzeniem — zero ruchu na saldzie. Zbuduj i przetestuj całą integrację, a gdy będzie gotowa, zmień klucz. To wszystko.

Najczęstsze pytania

Jak uzyskać dostęp? +
Dostęp jest na zaproszenie, konto po koncie. Otwierasz zwykłe konto NullShip, kontaktujesz się z nami przez ticket lub PGP, opisując co chcesz zbudować, robisz pierwsze doładowanie, a operator włącza API i generuje Twoją parę kluczy — sandbox i produkcja — którą widzisz tylko raz, przy tworzeniu.
Ile kosztuje API? +
Nic ponad etykiety. Płacisz za przesyłkę; warstwa hurtowa jest darmowa. Marżę ustalasz sam i jest Twoja.
Jakie kraje i jakich przewoźników obejmuje? +
Główne sieci w Europie (ES, IT, NL, DE, FR i ponad 30 celów w UE): UPS, DHL, DPD, GLS, InPost, BRT, Correos, SEUR, Poste Italiane i inni, zależnie od korytarza.
Czy muszę programować? +
Niekoniecznie. Jeśli chcesz, integrujesz API REST. Jeśli nie, używasz kreatora webowego, bota Telegram lub mini-aplikacji i odsprzedajesz bez pisania linijki kodu.
Jak otrzymuję wypłatę? +
W każdym cyklu wypłacasz zgromadzoną marżę w BTC, LTC lub XMR, albo przenosisz ją na saldo innego konta. Wszystko jest zapisane w rejestrze ruchów w panelu.

Gotów odsprzedawać pod własną marką?

Dostęp jest na zaproszenie. Otwórz konto, załóż ticket (lub napisz do nas przez PGP) i powiedz, co chcesz zbudować, a włączymy sandbox i produkcję.

Załóż konto →