Skip to main content

Integração REST (sem SDK)

A NZOChain disponibiliza actualmente integração através da REST API. Não existe ainda um SDK oficial publicado (incluindo @nzochain/sdk). Usa HTTP com o header X-API-Key. Base URL:
Contrato recomendado para produtos novos: /v1/.... Detalhe: API v1 · Autenticação · Erros.

B2C — proteger a tua wallet

  1. Abre app.nzochain.com.
  2. Liga a carteira e assina uma mensagem. É prova de posse — não move fundos.
  3. A NZOChain analisa aprovações, contratos e ligações nas 4 redes suportadas (Ethereum, BNB Chain, Polygon, Arbitrum).
  4. Vês o nível de risco e o que está activo.
  5. Para revogar, confirmas a transacção na tua carteira.
Se alguém a fingir ser a NZOChain pedir seed ou chave privada, é phishing. Nós nunca pedimos isso.
Planos: Free → Premium.

B2B — primeira chamada REST

1. Obter a API Key

  1. Cria conta em developers.nzochain.com.
  2. Cria um projecto.
  3. Gera uma API key (pk_live_...). Por omissão as keys novas incluem o scope wallet.scan (necessário para POST /v1/wallets/risk).

2. Autenticação

Header obrigatório nas rotas B2B v1:
Não uses Authorization: Bearer nestas rotas. Guia: Autenticação.

3. Primeira chamada (cURL)

network: ethereum | bnb | polygon | arbitrum.

4. Equivalente com JavaScript fetch

Coloca a chave só no servidor. Nunca no JavaScript público de um dApp.

5. Forma da resposta (contrato v1)

Campos úteis em data (quando success: true):

6. Erros comuns

Tabela completa: Erros.

7. Limites do plano (resumo)

Wallet/contract risk está no Free. analyze / simulate exigem Starter+. Threat intel exige Growth+.

8. Próximos passos

O caminho legado POST /api/risk/scan continua operacional para a app B2C e integrações antigas, mas não é a integração recomendada para produtos novos. Ver Risk Scan (legado).