← Blog
10 min de lecture
|
Publié le
|
Mis à jour le

API blockchain : ce qu'elle fait et pourquoi l'utiliser

Une API blockchain permet à votre logiciel de lire les chaînes et d'envoyer des transactions en HTTPS, sans nœud. Périmètre, authentification et limites.

Chapitres
C
Chaingateway Team
Experts blockchain

Relu par Maurice Sobiera

Une API blockchain est une interface web qui permet à votre logiciel de lire des données blockchain et d’envoyer des transactions sans nœud. Vous envoyez des requêtes HTTPS et recevez du JSON, plutôt que le protocole natif de chaque chaîne. L’API Chaingateway couvre Bitcoin, Ethereum, Tron, BNB Smart Chain, Polygon, Arbitrum et Solana derrière un seul schéma d’authentification.

Pourquoi les blockchains ont-elles besoin d’une couche API ?

Chaque chaîne a sa propre interface native, et aucune n’est conçue pour les développeurs d’applications. Un nœud expose des méthodes bas niveau, des encodages bruts et son propre format d’adresse. Le tableau indique par où un développeur commence sans couche API.

Famille de chaînesInterface nativeCe que vous gérez vous-même
Ethereum, BNB Smart Chain, Polygon, ArbitrumJSON-RPC sur votre propre nœud ou un point d’accès hébergéQuantités en hexadécimal, décodage ABI des transferts de tokens, réglages du gas
BitcoinRPC de Bitcoin CoreGestion des UTXO, estimation des frais, fichiers de portefeuille
Troninterfaces des nœuds java-tron, plug-ins HTTP et d’événementsRessources d’énergie et de bande passante, transactions basées sur protobuf

Une couche API place un style de requête unique par-dessus ces interfaces. Créer une adresse se fait avec POST /api/v2/<chain>/addresses sur Ethereum, BNB Smart Chain, Polygon, Arbitrum, Tron et Solana. Bitcoin utilise des portefeuilles, créés avec POST /api/v2/bitcoin/wallets. Les transferts de tokens suivent le même schéma sur chaque chaîne qui en possède. Les différences qui subsistent sont réelles, comme les ressources de Tron ou les frais de Bitcoin. L’article API blockchain vs nœud compare les deux approches plus en détail.

Que pouvez-vous faire avec une API blockchain ?

Vous pouvez créer des adresses, envoyer la monnaie native et des tokens, lire les blocs et les transactions, et recevoir des notifications. Dans la référence API de Chaingateway, les groupes principaux sont les suivants :

  • Adresses : créer (avec ou sans mot de passe qui chiffre la clé), importer et lister des adresses
  • Transactions : envoyer la monnaie native, des tokens ERC20/TRC20/BEP20 et des NFT ERC721, et lire les transactions
  • Données réseau : numéro du dernier bloc et prix du gas sur les chaînes EVM
  • Webhooks : enregistrer une adresse et une URL, puis recevoir un POST quand une transaction correspondante a lieu
  • Tron uniquement : geler et déléguer des ressources d’énergie et de bande passante

Toutes les chaînes ne disposent pas de tous les groupes. Solana n’a pas de webhooks, par exemple. Le fichier OpenAPI indique exactement quels endpoints existent pour quelle chaîne.

Comment fonctionne l’authentification ?

Chaque requête transporte un jeton porteur (bearer token) dans l’en-tête Authorization, comme défini dans la RFC 6750. Le mainnet est le réseau par défaut. Pour utiliser un réseau de test, ajoutez l’en-tête X-Network: testnet :

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

Le même appel sans le second en-tête renvoie le dernier bloc du mainnet. Les réseaux de test sont Sepolia pour Ethereum, Nile pour Tron, Amoy pour Polygon et Devnet pour Solana, entre autres. La liste complète figure sur la page réseaux pris en charge. Gardez le jeton sur votre serveur : quiconque le possède peut utiliser votre compte.

Quels cas d’usage conviennent à une API blockchain ?

L’acceptation de paiements, la surveillance des dépôts et la distribution de tokens sont les cas les plus courants. Une boutique attribue une adresse propre à chaque commande et y enregistre un webhook. Une plateforme d’échange ou un service de portefeuille fait de même pour les dépôts des utilisateurs. Un projet qui verse des tokens à de nombreux destinataires envoie une requête de transfert par destinataire. L’article sur la chaîne d’approvisionnement décrit un flux de paiement avec une référence de facture.

Les versions précédentes de cet article citaient aussi les applications décentralisées, la vérification d’identité et la création de smart contracts comme fonctions de l’API. L’API ne déploie pas de smart contracts, et la vérification d’identité n’en fait pas partie. La logique propre à une dApp vit dans des contrats que vous déployez avec d’autres outils. L’API sert à votre serveur pour dialoguer avec la chaîne qui les entoure.

À quoi ressemble une intégration ?

Une intégration de paiement comporte cinq étapes, et chacune correspond à une seule requête :

  1. Créez une adresse pour la commande ou l’utilisateur : POST /api/v2/ethereum/addresses avec un password. La réponse contient la nouvelle adresse.
  2. Enregistrez un webhook pour cette adresse avec POST /api/v2/ethereum/webhooks, en indiquant l’URL de votre récepteur dans url.
  3. Montrez l’adresse au payeur.
  4. Votre récepteur reçoit un POST avec l’identifiant de la transaction, l’expéditeur, le destinataire, le numéro de bloc et le type. Il répond par un statut de succès.
  5. Renvoyez les fonds avec POST /api/v2/ethereum/transactions, ou .../transactions/erc20 pour un token.

Testez d’abord les cinq étapes avec X-Network: testnet. Les coins de test n’ont aucune valeur : une erreur ne coûte donc rien.

Que ne fait pas une API blockchain ?

Elle ne modifie pas le fonctionnement de la chaîne. Limites à prévoir :

  • Une transaction peut encore échouer, par exemple faute de gas. Le délai de confirmation est fixé par la chaîne, pas par l’API.
  • Les webhooks ne sont pas renvoyés automatiquement. Les notifications échouées sont listées, et vous demandez leur renvoi.
  • Les clés demandent de la prudence. Un portefeuille créé sans mot de passe renvoie sa clé privée dans la réponse. Avec un mot de passe, la clé est stockée chiffrée côté Chaingateway. Chaingateway ne conserve pas le mot de passe : un mot de passe perdu signifie que le portefeuille ne peut pas être restauré.
  • Un fournisseur reste une dépendance. Conservez vos propres enregistrements de chaque identifiant de transaction créé.

Comment nous rédigeons ces articles

Prêt à le construire vous-même ? Obtenir votre clé API — essai de 7 jours, sans carte bancaire — ou consultez API Blockchain pour la référence complète des endpoints.

C
Chaingateway Team
Experts blockchain

L'équipe Chaingateway s'attache à simplifier l'intégration blockchain pour les développeurs du monde entier.