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:
/v1/.... Detalhe: API v1 · Autenticação · Erros.
B2C — proteger a tua wallet
- Abre app.nzochain.com.
- Liga a carteira e assina uma mensagem. É prova de posse — não move fundos.
- A NZOChain analisa aprovações, contratos e ligações nas 4 redes suportadas (Ethereum, BNB Chain, Polygon, Arbitrum).
- Vês o nível de risco e o que está activo.
- Para revogar, confirmas a transacção na tua carteira.
B2B — primeira chamada REST
1. Obter a API Key
- Cria conta em developers.nzochain.com.
- Cria um projecto.
- Gera uma API key (
pk_live_...). Por omissão as keys novas incluem o scopewallet.scan(necessário paraPOST /v1/wallets/risk).
2. Autenticação
Header obrigatório nas rotas B2B v1:Authorization: Bearer nestas rotas. Guia: Autenticação.
3. Primeira chamada (cURL)
network: ethereum | bnb | polygon | arbitrum.
4. Equivalente com JavaScript fetch
5. Forma da resposta (contrato v1)
Campos úteis emdata (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
- Referência de endpoints: API v1
- Quotas e redes: Overview
- Webhook live (
revocation.completed): Webhooks - Guia no portal (após login): developers.nzochain.com/quickstart
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).