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.
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 catene | Interfaccia nativa | Cosa gestisci da solo |
|---|---|---|
| Ethereum, BNB Smart Chain, Polygon, Arbitrum | JSON-RPC sul proprio nodo o su un endpoint ospitato | Quantità codificate in esadecimale, decodifica ABI dei trasferimenti di token, impostazioni del gas |
| Bitcoin | Bitcoin Core RPC | Gestione degli UTXO, stima delle commissioni, file dei wallet |
| Tron | interfacce del nodo java-tron, plugin HTTP ed eventi | Risorse 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:
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:
- Crea un indirizzo per l’ordine o l’utente:
POST /api/v2/ethereum/addressescon unapassword. La risposta contiene il nuovo indirizzo. - Registra un webhook per quell’indirizzo con
POST /api/v2/ethereum/webhooks, con l’URL del tuo ricevitore inurl. - Mostra l’indirizzo a chi paga.
- Il tuo ricevitore riceve una POST con ID della transazione, mittente, destinatario, numero di blocco e tipo. Risponde con uno stato di successo.
- Inoltra i fondi con
POST /api/v2/ethereum/transactions, oppure.../transactions/erc20per 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.