FAQ sull'API blockchain per sviluppatori
Questa FAQ risponde alle domande che gli sviluppatori pongono più spesso sull’API Chaingateway: come autenticarsi, quali reti esistono, come testare, come appaiono gli errori e come ottenere supporto. Chaingateway è un’API REST con cui un’applicazione crea wallet, invia transazioni, legge dati blockchain e riceve webhook. Ogni risposta rinvia alla pagina con i dettagli.
Come inizio e come mi autentico?
Sezione intitolata “Come inizio e come mi autentico?”Registra un account, crea una API key nella dashboard e inviala come Bearer token. La prova gratuita di 7 giorni non richiede una carta. La Guida rapida illustra la prima richiesta.
Cos’è Chaingateway.io?
Chaingateway.io è una piattaforma che fornisce soluzioni di API blockchain e
consente agli sviluppatori di integrare funzionalità blockchain nelle loro
applicazioni. Un’unica interfaccia REST copre wallet, transazioni, saldi, blocchi
e webhook su diverse reti blockchain.
Come inizio con Chaingateway.io?
Per iniziare, registrati per un account su
Chaingateway.io. Una volta registrato,
puoi creare una API key nella dashboard, alla voce API tokens. Ti serve per autenticare
le tue richieste API. La documentazione fornisce guide ed esempi per
aiutarti a integrare l’API nella tua applicazione.
Come autentico le mie richieste API?
Le richieste API verso Chaingateway.io devono essere autenticate con una API key. Crea la chiave nella dashboard dopo l’accesso. Inviala come Bearer token negli header delle tue richieste HTTP:
Authorization: Bearer YOUR_API_KEYUna richiesta senza token valido restituisce HTTP 401 con il corpo {"message":"Unauthenticated."}. Non inserire la chiave nel codice lato client né in un repository.
Esistono limiti di utilizzo per le API?
Sì, esistono limiti di utilizzo basati sul tuo piano di abbonamento. I piani di
livello superiore offrono quote di utilizzo più alte. Informazioni dettagliate su limiti e prezzi sono disponibili nella nostra pagina
prezzi. Ad esempio, creare più indirizzi di quelli consentiti dal tuo piano restituisce
lo stato 422 con il messaggio Your address limit exceeded. Please upgrade your plan.
Quali reti ed endpoint sono disponibili?
Sezione intitolata “Quali reti ed endpoint sono disponibili?”L’API supporta sette blockchain, ciascuna con una mainnet e una testnet, e offre su di esse gestione dei wallet, gestione delle transazioni, webhook e recupero dei dati. Reti supportate elenca le reti e i valori dell’header X-Network.
Quali reti blockchain sono supportate?
Chaingateway.io supporta le seguenti reti blockchain:
- Ethereum (mainnet e Sepolia)
- Binance Smart Chain (mainnet e testnet)
- Bitcoin (mainnet e testnet3)
- Polygon (mainnet e Amoy)
- Tron (mainnet e Nile)
- Arbitrum (mainnet e Arbitrum Sepolia)
- Solana (mainnet e devnet)
Per maggiori informazioni su come accedere alle diverse reti, visita Reti supportate.
Che tipo di API offre Chaingateway.io?
L’API copre queste aree:
- Gestione dei wallet: Creare e gestire wallet.
- Gestione delle transazioni: Inviare coin native e token, e leggere le transazioni.
- Instant Payment Notification: Ricevere notifiche webhook sugli eventi blockchain.
- Recupero dati: Recuperare dati blockchain come saldi, blocchi e prezzi di mercato.
Il file OpenAPI elenca più di 200 operazioni. L’API reference documenta ciascuna di esse.
Posso testare le API in un ambiente sandbox?
Sì, ogni blockchain supportata ha una testnet. Aggiungi l’header X-Network: testnet a una richiesta per eseguirla sulla rete di test. Senza l’header, o con X-Network: mainnet, la richiesta viene eseguita sulla rete principale. In questo modo puoi testare la tua integrazione senza muovere fondi reali.
Consulta Reti supportate per sapere come accedere alle diverse reti.
Come gestisco gli errori e i fallimenti dei webhook?
Sezione intitolata “Come gestisco gli errori e i fallimenti dei webhook?”Controlla il campo ok di ogni risposta e registra message ed errors quando è false. Le consegne di webhook fallite non vengono ritentate automaticamente. Le elenchi e le reinvii tu stesso.
Come gestisco gli errori dell’API?
Se una richiesta API fallisce, la risposta include uno stato e un messaggio che indicano il problema. Il file OpenAPI documenta questi codici di stato:
400: Bad Request. Esempio: non è stato possibile leggere il contratto TRC20.401: Unauthorized. La API key non è valida o manca, oppure la password del wallet è errata.404: Not Found. Esempio: un id di webhook che non esiste.422: Unprocessable Entity. La richiesta era ben formata, ma la validazione è fallita o la blockchain ha rifiutato la transazione, ad esempio per fondi insufficienti.
Consulta la sezione di gestione degli errori nella nostra documentazione per maggiori dettagli. Aggiungiamo anche informazioni utili nel corpo della risposta. Ecco un esempio:
{ "status": 422, "ok": false, "message": "insufficient funds for gas * price + value: balance 2000000000000, tx cost 195000000000000, overshot 193000000000000", "errors": []}{ "status": 422, "ok": false, "message": "Data validation failed", "errors": { "password": ["The password field is required."] }}Come ricevo notifiche sui pagamenti in entrata?
Crea un webhook con POST /api/v2/{chain}/webhooks. Chaingateway invia quindi una richiesta HTTP POST al tuo URL per ogni transazione corrispondente. I webhook esistono per Ethereum, BNB Smart Chain, Polygon, Arbitrum, TRON e Bitcoin, ma non per Solana.
Una consegna fallita non viene ritentata automaticamente. Elenca le notifiche fallite con GET /api/v2/{chain}/webhooks/notifications/failed e reinviane una con POST /api/v2/{chain}/webhooks/notifications/{id}/retry. Vedi Webhook e Sicurezza dei webhook.
Quale tipo di wallet devo usare?
Usa un wallet protetto da password per gli indirizzi di lunga durata. Invii una password quando crei l’indirizzo, e le transazioni successive vengono firmate con quella password. Usa un wallet non protetto solo per indirizzi temporanei, perché la private key viene restituita nella risposta e devi conservarla tu. Chaingateway non memorizza le password e non può ripristinarne una persa. Vedi Gestione wallet.
Dove posso monitorare l’utilizzo e ottenere supporto?
Sezione intitolata “Dove posso monitorare l’utilizzo e ottenere supporto?” Come posso monitorare il mio utilizzo dell’API?
Puoi monitorare il tuo utilizzo dell’API dalla dashboard, che fornisce analisi
e report sul numero di richieste effettuate, sull’utilizzo dei dati e sugli
errori riscontrati.
Come ottengo supporto in caso di problemi?
Per ricevere supporto, puoi contattarci tramite il nostro portale di supporto disponibile nella dashboard. Offriamo anche un forum della community e una documentazione approfondita che può aiutare a risolvere i problemi più comuni.
Per questioni urgenti, contatta direttamente il nostro team di supporto via email a support@chaingateway.io, tramite Telegram, o tramite la chat web sul sito.
Gestiamo inoltre una community Telegram dove puoi trovare discussioni utili.
Esiste un programma di referral o partnership?
Sì, offriamo programmi di referral e partnership per sviluppatori e aziende
interessati a promuovere Chaingateway.io. Per maggiori informazioni, visita
la nostra pagina partner.
Dove posso trovare gli ultimi aggiornamenti e le notizie su Chaingateway.io?
Resta aggiornato sulle ultime notizie, i rilasci di funzionalità e gli annunci seguendo il nostro blog e iscrivendoti alla nostra newsletter.
- RFC 9110, HTTP Semantics definisce i codici di stato nell’elenco degli errori.
- RFC 6750, Bearer Token Usage definisce l’header
Authorization: Bearer. - Il file OpenAPI elenca ogni endpoint con le sue risposte documentate.