← Blog
🔌 API all'ingrosso

Lancia il tuo brand di spedizioni
senza costruire una sola integrazione con i corrieri.

Collegarsi a UPS, DHL, InPost, Correos, Poste Italiane, DPD, GLS e SEUR di solito richiede settimane di contratti, account commerciali e API che cambiano ogni trimestre. L'API all'ingrosso di NullShip mette tutto questo dietro un unico token: tu vendi etichette ai tuoi clienti al tuo prezzo, e noi ci occupiamo dell'idraulica con i corrieri. Una sola API REST, JSON dall'inizio alla fine, su Tor — imposti il margine, tieni il guadagno e incassi in cripto.

1. Il problema: rivendere etichette di spedizione è costoso da costruire

Ogni corriere ha il suo onboarding, il suo formato di etichetta e la sua idea di cosa sia un codice postale valido. Moltiplicalo per decine di servizi e 30 paesi e hai un progetto di mesi prima di vendere la prima etichetta — più una manutenzione infinita ogni volta che uno di loro cambia qualcosa.

L'alternativa abituale è rivendere a mano: prendere l'ordine in chat, pagarlo tu, inoltrare il PDF. Non scala e non ti lascia né prezzi coerenti né contabilità.

2. Cos'è: uno strato all'ingrosso pronto per rivendere

POST /api/v1/rates restituisce tariffe in tempo reale; POST /api/v1/labels genera l'etichetta reale e ti consegna il PDF. Sotto, il nostro strato di routing sceglie la fonte migliore per ogni corridoio e te la serve all'istante — quella logica è nostra e tu non la vedi. Parli con un unico endpoint e ottieni sempre la tariffa giusta, senza contratti né integrazioni da mantenere.

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

Tariffe in tempo reale di un corridoio — la stessa chiamata funziona in sandbox o in produzione.

3. Sotto-account: i tuoi clienti, il tuo brand

Il cuore del modello reseller. Crei sotto-account per i tuoi clienti — ognuno con il suo saldo, la sua cronologia di etichette e il suo login. Ogni chiamata che fai per loro porta un X-Sub-Account-Id, così il sistema attribuisce ogni costo e ogni margine alla persona giusta, automaticamente.

POST /api/v1/sub-accounts — registri un cliente
GET /api/v1/sub-accounts/me/labels — il cliente consulta le sue spedizioni
POST /api/v1/sub-accounts/me/topup — il cliente ricarica il saldo (fattura cripto) o riscatta un codice prepagato

Costruisci il tuo front-end con signup-token → register → auth, oppure ti risparmi lo sviluppo e usi la nostra procedura guidata web, il bot Telegram o la mini-app — pensati per reseller che non vogliono programmare.

4. Imposti il prezzo, tieni il margine

Definisci il tuo markup — globale o per corridoio paese-paese. Ogni etichetta che vende un tuo cliente ti genera un guadagno che si accumula nel tuo ciclo di commissioni. Alla chiusura lo prelevi: in cripto (BTC / LTC / XMR) o spostato sul saldo di un altro account. Il pannello ti mostra ogni movimento, quali sotto-account sono online in tempo reale e il dettaglio del guadagno per vendita.

🔒 5. Privacy di serie

NullShip è onion-only per design: l'API vive su un servizio .onion, con autenticazione tramite token bearer e chiavi mostrate una sola volta (conserviamo solo l'hash). Pagamenti e payout in cripto. Nessun JavaScript obbligatorio — funziona anche con Tor al livello di sicurezza massimo.

6. Prova prima di spendere un centesimo

Ogni partner riceve due chiavi: nsk_test_* (sandbox) e nsk_live_* (produzione). In sandbox, /rates restituisce dati reali e /labels ti dà un'etichetta sintetica con tracking falso — zero movimento di saldo. Costruisci e testi tutta la tua integrazione, e quando è pronta cambi chiave. Tutto qui.

Domande frequenti

Come ottengo l'accesso? +
L'accesso è su invito, account per account. Apri un normale account NullShip, ci contatti via ticket o PGP descrivendo cosa vuoi costruire, fai una ricarica iniziale e l'operatore abilita l'API e genera la tua coppia di chiavi — sandbox e produzione —, che vedi una sola volta, alla creazione.
Quanto costa l'API? +
Niente oltre alle etichette. Paghi la spedizione; lo strato all'ingrosso è gratis. Il tuo margine lo imposti tu ed è tuo.
Quali paesi e corrieri copre? +
Le principali reti d'Europa (ES, IT, NL, DE, FR e oltre 30 destinazioni UE): UPS, DHL, DPD, GLS, InPost, BRT, Correos, SEUR, Poste Italiane e altri, a seconda del corridoio.
Devo programmare? +
Non necessariamente. Se vuoi, integri l'API REST. Altrimenti usi la procedura guidata web, il bot Telegram o la mini-app e rivendi senza scrivere una riga di codice.
Come vengo pagato? +
A ogni ciclo prelevi il margine accumulato in BTC, LTC o XMR, oppure lo sposti sul saldo di un altro account. Tutto è registrato nel libro movimenti del pannello.

Pronto a rivendere con il tuo brand?

L'accesso è su invito. Apri un account, apri un ticket (o scrivici via PGP) raccontandoci cosa vuoi costruire, e attiviamo sandbox e produzione.

Crea un account →