← Blog
🔌 API grossista

Lance a sua própria marca de envios
sem construir uma única integração de transportadora.

Ligar-se à UPS, DHL, InPost, Correos, Poste Italiane, DPD, GLS e SEUR significa, normalmente, semanas de contratos, contas comerciais e APIs que mudam a cada trimestre. A API grossista da NullShip coloca tudo isso atrás de um único token: vende etiquetas aos seus próprios clientes ao seu preço, e nós tratamos da canalização com as transportadoras. Uma única API REST, JSON de ponta a ponta, sobre Tor — define a sua margem, fica com o lucro e recebe em cripto.

1. O problema: revender etiquetas de envio é caro de construir

Cada transportadora tem o seu próprio onboarding, o seu próprio formato de etiqueta e a sua própria ideia do que é um código postal válido. Multiplique isso por dezenas de serviços e 30 países e tem um projeto de meses antes de vender a primeira etiqueta — mais uma manutenção interminável sempre que uma delas muda algo.

A alternativa habitual é revender à mão: receber a encomenda no chat, pagá-la você, reencaminhar o PDF. Não escala e deixa-o sem preços consistentes nem contabilidade.

2. O que é: uma camada grossista pronta para revender

POST /api/v1/rates devolve tarifas em tempo real; POST /api/v1/labels gera a etiqueta real e entrega-lhe o PDF. Por baixo, a nossa camada de encaminhamento escolhe a melhor fonte para cada corredor e serve-lha de imediato — essa lógica é nossa e você nunca a vê. Fala com um único endpoint e obtém sempre a tarifa certa, sem contratos nem integrações para manter.

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

Tarifas em tempo real de um corredor — a mesma chamada funciona em sandbox ou em produção.

3. Subcontas: os seus clientes, a sua marca

O coração do modelo de revenda. Cria subcontas para os seus próprios clientes — cada uma com o seu saldo, o seu histórico de etiquetas e o seu login. Cada chamada que faz em nome deles leva um X-Sub-Account-Id, por isso o sistema atribui cada custo e cada margem a quem corresponde, automaticamente.

POST /api/v1/sub-accounts — regista um cliente
GET /api/v1/sub-accounts/me/labels — o cliente consulta os seus envios
POST /api/v1/sub-accounts/me/topup — o cliente carrega saldo (fatura cripto) ou resgata um código pré-pago

Constrói o seu próprio front-end com signup-token → register → auth, ou poupa o desenvolvimento e usa o nosso assistente web, o bot do Telegram ou a mini-app — pensados para revendedores que não querem programar.

4. Você define o preço, você fica com a margem

Define a sua margem — global ou por corredor país a país. Cada etiqueta que um cliente seu compra gera-lhe um lucro que se acumula no seu ciclo de comissões. No fecho, levanta-o: em cripto (BTC / LTC / XMR) ou transferido para o saldo de outra conta. O painel mostra-lhe cada movimento, que subcontas estão online em direto, e o detalhe do lucro por venda.

🔒 5. Privado por defeito

A NullShip é onion-only por conceção: a API vive num serviço .onion, com autenticação por token bearer e chaves mostradas uma única vez (guardamos apenas o hash). Pagamentos e levantamentos em cripto. Sem JavaScript obrigatório — funciona mesmo com o Tor no nível de segurança máximo.

6. Teste antes de gastar um cêntimo

Cada parceiro recebe duas chaves: nsk_test_* (sandbox) e nsk_live_* (produção). Em sandbox, /rates devolve dados reais e /labels dá-lhe uma etiqueta sintética com tracking falso — zero movimento de saldo. Constrói e testa toda a sua integração, e quando estiver pronta, troca de chave. É só.

Perguntas frequentes

Como consigo acesso? +
O acesso é por convite, conta a conta. Abre uma conta normal na NullShip, contacta-nos por ticket ou PGP a descrever o que quer construir, faz um carregamento inicial, e o operador ativa a API e gera o seu par de chaves — sandbox e produção —, que vê uma única vez, na criação.
Quanto custa a API? +
Nada acima das etiquetas. Paga o envio; a camada grossista é gratuita. A sua margem é você que a define e é sua.
Que países e transportadoras cobre? +
As principais redes da Europa (ES, IT, NL, DE, FR e mais de 30 destinos UE): UPS, DHL, DPD, GLS, InPost, BRT, Correos, SEUR, Poste Italiane e outras, conforme o corredor.
Preciso de programar? +
Não necessariamente. Se quiser, integra a API REST. Se não, usa o assistente web, o bot do Telegram ou a mini-app e revende sem escrever uma linha de código.
Como recebo os meus lucros? +
Em cada ciclo levanta a margem acumulada em BTC, LTC ou XMR, ou passa-a para o saldo de outra conta. Tudo fica registado no livro de movimentos do painel.

Pronto para revender com a sua marca?

O acesso é por convite. Abra uma conta, abra um ticket (ou contacte-nos por PGP) a dizer-nos o que quer construir, e ativamos sandbox e produção.

Criar uma conta →