← Blog
10 min di lettura
|
Pubblicato
|
Aggiornato

API blockchain: cos'è, a cosa serve e perché usarne una

Un'API blockchain permette al software di leggere le catene e inviare transazioni via HTTPS, senza nodi. Cosa copre, come funziona l'accesso e dove si ferma.

Capitoli
C
Chaingateway Team
Esperti di blockchain

Verificato da Maurice Sobiera

Un’API blockchain è un’interfaccia web che permette al software di leggere dati blockchain e inviare transazioni senza far girare un nodo. Invii richieste HTTPS e ricevi JSON, invece di parlare il protocollo nativo di ogni catena. L’API di Chaingateway copre Bitcoin, Ethereum, Tron, BNB Smart Chain, Polygon, Arbitrum e Solana dietro un unico schema di autenticazione.

Perché le blockchain hanno bisogno di uno strato API?

Ogni catena ha una propria interfaccia nativa, e nessuna è pensata per gli sviluppatori di applicazioni. Un nodo espone metodi di basso livello, codifiche grezze e un proprio formato degli indirizzi. La tabella mostra da dove parte uno sviluppatore senza uno strato API.

Famiglia di cateneInterfaccia nativaCosa gestisci da solo
Ethereum, BNB Smart Chain, Polygon, ArbitrumJSON-RPC sul proprio nodo o su un endpoint ospitatoQuantità codificate in esadecimale, decodifica ABI dei trasferimenti di token, impostazioni del gas
BitcoinBitcoin Core RPCGestione degli UTXO, stima delle commissioni, file dei wallet
Troninterfacce del nodo java-tron, plugin HTTP ed eventiRisorse di Energy e Bandwidth, transazioni basate su protobuf

Uno strato API mette uno stile di richiesta unico sopra queste differenze. Creare un indirizzo è POST /api/v2/<chain>/addresses su Ethereum, BNB Smart Chain, Polygon, Arbitrum, Tron e Solana. Bitcoin usa i wallet, creati con POST /api/v2/bitcoin/wallets. I trasferimenti di token seguono lo stesso schema su ogni catena che ha token. Restano le differenze reali tra le catene, come le risorse di Tron o le commissioni di Bitcoin. L’articolo API blockchain contro nodo confronta in dettaglio i due approcci.

Che cosa si può fare con un’API blockchain?

Si possono creare indirizzi, inviare moneta nativa e token, leggere blocchi e transazioni, e ricevere notifiche. Nel riferimento dell’API di Chaingateway i gruppi principali sono questi:

  • Indirizzi: creare (con o senza una password che cifra la chiave), importare ed elencare gli indirizzi
  • Transazioni: inviare moneta nativa, token ERC20/TRC20/BEP20 e NFT ERC721, e leggere le transazioni
  • Dati di rete: numero dell’ultimo blocco e prezzo del gas sulle catene EVM
  • Webhook: registrare un indirizzo e un URL, poi ricevere una POST quando avviene una transazione corrispondente
  • Solo Tron: congelare e delegare risorse per energy e bandwidth

Non tutte le catene hanno tutti i gruppi. Solana, per esempio, non ha webhook. Il file OpenAPI elenca esattamente quali endpoint esistono per quale catena.

Come funziona l’autenticazione?

Ogni richiesta porta un bearer token nell’header Authorization, come definito nella RFC 6750. La mainnet è il default. Per usare una rete di test, aggiungi l’header X-Network: testnet:

Terminal window
curl https://app.chaingateway.io/api/v2/ethereum/blocks/number \
-H "Authorization: Bearer $CHAINGATEWAY_TOKEN" \
-H "X-Network: testnet"

La stessa chiamata senza il secondo header restituisce l’ultimo blocco della mainnet. Le testnet sono Sepolia per Ethereum, Nile per Tron, Amoy per Polygon e Devnet per Solana, tra le altre. L’elenco completo è nella pagina sulle reti supportate. Tieni il token sul server. Chiunque lo possieda può usare il tuo account.

Quali casi d’uso si adattano a un’API blockchain?

Accettazione di pagamenti, monitoraggio dei depositi e distribuzione di token sono i casi più comuni. Un negozio assegna a ogni ordine un proprio indirizzo e registra per esso un webhook. Un exchange o un servizio wallet fa lo stesso per i depositi degli utenti. Un progetto che paga token a molti destinatari invia una richiesta di trasferimento per ciascun destinatario. L’articolo sulla supply chain illustra un flusso di pagamento con un riferimento di fattura.

Le versioni precedenti di questo articolo elencavano anche le applicazioni decentralizzate, la verifica dell’identità e la creazione di smart contract tra le funzioni dell’API. L’API non distribuisce smart contract, e la verifica dell’identità non ne fa parte. La logica di una dApp vive in contratti che si distribuiscono con altri strumenti. L’API è il modo in cui il tuo server parla con la catena attorno a quei contratti.

Com’è fatta un’integrazione?

Un’integrazione di pagamento ha cinque passaggi, e ciascuno è una singola richiesta:

  1. Crea un indirizzo per l’ordine o l’utente: POST /api/v2/ethereum/addresses con una password. La risposta contiene il nuovo indirizzo.
  2. Registra un webhook per quell’indirizzo con POST /api/v2/ethereum/webhooks, con l’URL del tuo ricevitore in url.
  3. Mostra l’indirizzo a chi paga.
  4. Il tuo ricevitore riceve una POST con ID della transazione, mittente, destinatario, numero di blocco e tipo. Risponde con uno stato di successo.
  5. Inoltra i fondi con POST /api/v2/ethereum/transactions, oppure .../transactions/erc20 per un token.

Prova prima tutti e cinque i passaggi con X-Network: testnet. Le monete di test non hanno valore, quindi un errore non costa nulla.

Che cosa non fa un’API blockchain?

Non cambia il funzionamento della catena. Limiti da mettere in conto:

  • Una transazione può ancora fallire, per esempio per mancanza di gas. Il tempo di conferma lo stabilisce la catena, non l’API.
  • I webhook non vengono ritentati automaticamente. Le notifiche fallite sono elencate, e devi chiederne il reinvio.
  • Le chiavi richiedono attenzione. Un wallet creato senza password restituisce la sua chiave privata nella risposta. Con una password, la chiave viene conservata cifrata sul lato di Chaingateway. Chaingateway non memorizza la password, quindi una password smarrita significa che il wallet non può essere ripristinato.
  • Il provider resta una dipendenza. Conserva i tuoi registri di ogni ID di transazione che crei.

Come scriviamo questi articoli

Pronto a costruirlo da solo? Ottieni la tua API key — prova di 7 giorni, senza carta — oppure consulta Blockchain API per il riferimento completo degli endpoint.

C
Chaingateway Team
Esperti di blockchain

Il team di Chaingateway si impegna a semplificare l'integrazione blockchain per sviluppatori di tutto il mondo.