← Blog
🔌 API de gros

Lancez votre propre marque d'expédition
sans construire une seule intégration transporteur.

Se connecter à UPS, DHL, InPost, Correos, Poste Italiane, DPD, GLS et SEUR demande normalement des semaines de contrats, de comptes professionnels et d'API qui changent chaque trimestre. L'API de gros de NullShip met tout cela derrière un unique token : vous vendez des étiquettes à vos propres clients à votre prix, et nous gérons la plomberie avec les transporteurs. Une seule API REST, du JSON de bout en bout, sur Tor — vous fixez votre marge, gardez le bénéfice et encaissez en crypto.

1. Le problème : revendre des étiquettes d'expédition coûte cher à construire

Chaque transporteur a son propre onboarding, son propre format d'étiquette et sa propre idée de ce qu'est un code postal valide. Multipliez cela par des dizaines de services et 30 pays et vous avez un projet de plusieurs mois avant de vendre votre première étiquette — plus une maintenance sans fin chaque fois que l'un d'eux change quelque chose.

L'alternative habituelle est de revendre à la main : prendre la commande en chat, la payer vous-même, transférer le PDF. Ça ne passe pas à l'échelle et ça vous laisse sans prix cohérents ni comptabilité.

2. Ce que c'est : une couche de gros prête à revendre

POST /api/v1/rates renvoie des tarifs en temps réel ; POST /api/v1/labels génère l'étiquette réelle et vous remet le PDF. En dessous, notre couche de routage choisit la meilleure source pour chaque corridor et vous la sert instantanément — cette logique est la nôtre et vous ne la voyez jamais. Vous parlez à un seul endpoint et obtenez toujours le bon tarif, sans contrats ni intégrations à maintenir.

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

Tarifs en temps réel pour un corridor — le même appel fonctionne en sandbox ou en production.

3. Sous-comptes : vos clients, votre marque

Le cœur du modèle revendeur. Vous créez des sous-comptes pour vos propres clients — chacun avec son solde, son historique d'étiquettes et son login. Chaque appel que vous faites en leur nom porte un X-Sub-Account-Id, de sorte que le système attribue chaque coût et chaque marge à la bonne partie, automatiquement.

POST /api/v1/sub-accounts — vous enregistrez un client
GET /api/v1/sub-accounts/me/labels — le client consulte ses expéditions
POST /api/v1/sub-accounts/me/topup — le client recharge son solde (facture crypto) ou utilise un code prépayé

Construisez votre propre front-end avec signup-token → register → auth, ou évitez le développement et utilisez notre assistant web, le bot Telegram ou la mini-app — pensés pour les revendeurs qui ne veulent pas coder.

4. Vous fixez le prix, vous gardez la marge

Vous définissez votre marge — globale ou par corridor pays à pays. Chaque étiquette qu'un de vos clients achète génère un bénéfice qui s'accumule dans votre cycle de commissions. À la clôture, vous le retirez : en crypto (BTC / LTC / XMR) ou transféré sur le solde d'un autre compte. Le tableau de bord vous montre chaque mouvement, quels sous-comptes sont en ligne en direct, et le détail du bénéfice par vente.

🔒 5. Privé par défaut

NullShip est onion-only par conception : l'API vit sur un service .onion, avec authentification par token bearer et des clés affichées une seule fois (nous ne stockons que le hash). Paiements et retraits en crypto. Aucun JavaScript requis — ça marche même avec Tor au niveau de sécurité maximal.

6. Testez avant de dépenser un centime

Chaque partenaire reçoit deux clés : nsk_test_* (sandbox) et nsk_live_* (production). En sandbox, /rates renvoie de vraies données et /labels vous donne une étiquette synthétique avec un suivi fictif — aucun mouvement de solde. Construisez et testez toute votre intégration, et quand elle est prête, changez de clé. C'est tout.

Questions fréquentes

Comment obtenir un accès ? +
L'accès se fait sur invitation, compte par compte. Vous ouvrez un compte NullShip classique, vous nous contactez par ticket ou PGP en décrivant ce que vous voulez construire, vous faites une recharge initiale, et l'opérateur active l'API et génère votre paire de clés — sandbox et production —, que vous ne voyez qu'une seule fois, à la création.
Combien coûte l'API ? +
Rien en plus des étiquettes. Vous payez l'expédition ; la couche de gros est gratuite. Votre marge, c'est vous qui la fixez et elle est à vous.
Quels pays et transporteurs couvre-t-elle ? +
Les principaux réseaux d'Europe (ES, IT, NL, DE, FR et plus de 30 destinations UE) : UPS, DHL, DPD, GLS, InPost, BRT, Correos, SEUR, Poste Italiane et d'autres, selon le corridor.
Dois-je coder ? +
Pas forcément. Si vous voulez, vous intégrez l'API REST. Sinon, vous utilisez l'assistant web, le bot Telegram ou la mini-app et vous revendez sans écrire une ligne de code.
Comment suis-je payé ? +
À chaque cycle, vous retirez votre marge accumulée en BTC, LTC ou XMR, ou vous la transférez sur le solde d'un autre compte. Tout est enregistré dans le journal des mouvements du tableau de bord.

Prêt à revendre sous votre propre marque ?

L'accès se fait sur invitation. Ouvrez un compte, ouvrez un ticket (ou contactez-nous par PGP) en nous disant ce que vous voulez construire, et nous activons sandbox et production.

Créer un compte →