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

API BNB Smart Chain : ce que vous pouvez créer

Ce qu'une API BNB Smart Chain (BSC) fournit : portefeuilles, transferts BNB et BEP-20, soldes et webhooks, avec exemples de requêtes et limites du RPC public.

Chapitres
C
Chaingateway Team
Experts blockchain

Relu par Maurice Sobiera

Une API BNB Smart Chain est une interface web pour BNB Smart Chain (BSC), anciennement Binance Smart Chain. Elle permet de créer des portefeuilles, d’envoyer des BNB et des tokens BEP-20, de lire les soldes et de recevoir des dépôts, sans nœud BSC. Votre backend envoie des requêtes HTTPS ; le fournisseur gère la signature et la diffusion.

Cet article liste ce que couvre une telle API, montre deux requêtes contre les endpoints BSC de Chaingateway, et explique quand les endpoints RPC publics suffisent.

Que couvre une API BSC ?

Une API BSC couvre les opérations dont a besoin un backend de paiement ou de portefeuille. Les endpoints Chaingateway, tels que listés dans le fichier OpenAPI, se répartissent en cinq groupes :

GroupeEndpoints
AdressesPOST /api/v2/bsc/addresses crée un portefeuille, GET liste les portefeuilles, POST /api/v2/bsc/addresses/import importe une clé privée
SoldesGET /api/v2/bsc/balances/{address} pour le BNB, GET /api/v2/bsc/balances/{address}/bep20/{contract_address} pour un token BEP-20
TransfertsPOST /api/v2/bsc/transactions pour le BNB, POST /api/v2/bsc/transactions/bep20 pour les tokens BEP-20, POST /api/v2/bsc/transactions/bep721 pour les NFT
Données de chaîneDernier bloc, bloc par numéro ou par hash, transaction, reçu, prix du gas, propriétaire d’un NFT et URI de token
WebhooksCréer, mettre à jour et supprimer des webhooks, lister les notifications, lister les notifications échouées et les relancer

Toutes les requêtes utilisent un token bearer dans l’en-tête Authorization. Envoyez X-Network: testnet pour utiliser le réseau de test. Sans cet en-tête, la requête part sur le mainnet.

Comment vérifier un solde et envoyer du BNB ?

Vérifiez le solde avec une requête GET, puis envoyez du BNB avec une requête POST. Les deux exemples utilisent l’URL de base https://app.chaingateway.io et un token de votre tableau de bord.

Terminal window
curl https://app.chaingateway.io/api/v2/bsc/balances/0x0000000000000000000000000000000000001000 \
-H "Authorization: Bearer $CHAINGATEWAY_TOKEN" \
-H "X-Network: testnet"

La réponse contient le solde sous forme de chaîne décimale :

{"status": 200, "ok": true, "message": "Balance fetched", "data": "0.000000000000000000"}

Pour envoyer du BNB depuis un portefeuille créé avec l’API, transmettez l’expéditeur, le destinataire, le montant et le mot de passe du portefeuille. Les champs de gas sont facultatifs.

Terminal window
curl -X POST https://app.chaingateway.io/api/v2/bsc/transactions \
-H "Authorization: Bearer $CHAINGATEWAY_TOKEN" \
-H "X-Network: testnet" \
-H "Content-Type: application/json" \
-d '{"from": "0x...", "to": "0x...", "amount": "0.001", "password": "wallet-password"}'

Si l’expéditeur n’a pas assez de BNB pour le montant plus le gas, l’API renvoie le statut 422 avec le message insufficient funds du nœud. Un mot de passe de portefeuille erroné renvoie 401.

Comment lire le solde d’un token et une transaction ?

Lisez le solde d’un token BEP-20 avec l’adresse du portefeuille et l’adresse du contrat du token dans le chemin. Lisez une transaction avec son hash. Les deux sont des requêtes GET avec les mêmes en-têtes que ci-dessus.

Terminal window
# BEP-20 token balance
curl https://app.chaingateway.io/api/v2/bsc/balances/0xWalletAddress/bep20/0xTokenContract \
-H "Authorization: Bearer $CHAINGATEWAY_TOKEN"
# Transaction with decoded data
curl https://app.chaingateway.io/api/v2/bsc/transactions/0xTransactionHash/decoded \
-H "Authorization: Bearer $CHAINGATEWAY_TOKEN"
# Current gas price
curl https://app.chaingateway.io/api/v2/bsc/gasprice \
-H "Authorization: Bearer $CHAINGATEWAY_TOKEN"

Le endpoint de solde renvoie le montant du token sous forme de chaîne décimale : vous n’avez donc pas à le mettre à l’échelle vous-même avec les décimales du token. Le endpoint de transaction décodée renvoie une transaction en champs lisibles, au lieu de données hexadécimales brutes. Un hash inconnu renvoie une réponse 422 avec le message transaction not found.

GET /api/v2/bsc/transactions liste l’historique de vos propres transactions. Il ne liste que les transactions effectuées via l’API Chaingateway, car Chaingateway n’indexe pas vos adresses de lui-même. Utilisez un webhook pour voir les transferts entrants.

Si vous possédez déjà un portefeuille, POST /api/v2/bsc/addresses/import importe sa clé privée. Les portefeuilles importés et les nouveaux utilisent les mêmes endpoints d’envoi et de webhook.

Comment être averti des dépôts ?

Créez un webhook avec POST /api/v2/bsc/webhooks. Le champ url est obligatoire. Filtrez par to (une adresse de réception), par from, ou par contractaddress pour un token, et définissez type sur BNB, BEP20 ou BEP721. Lorsqu’une transaction correspondante est détectée, Chaingateway envoie les données de la transaction à votre URL.

Les webhooks ne sont pas relancés automatiquement. Une livraison échouée apparaît dans GET /api/v2/bsc/webhooks/notifications/failed, et POST /api/v2/bsc/webhooks/notifications/{id}/retry la renvoie. Rendez votre endpoint de réception idempotent, sur la base de l’identifiant de transaction, afin qu’une relance ne crédite pas un compte deux fois.

Qu’est-ce que BEP-20 ?

BEP-20 est le standard de token de BNB Smart Chain. Selon sa spécification, il dérive de l’ERC-20 d’Ethereum et impose les fonctions symbol(), decimals(), totalSupply(), balanceOf(), transfer(), transferFrom(), approve() et allowance(). C’est pourquoi le même code de portefeuille fonctionne pour les tokens sur BSC et sur Ethereum, et pourquoi les endpoints BSC de Chaingateway reprennent ceux d’Ethereum.

Quand les endpoints RPC publics suffisent-ils ?

BNB Chain publie des endpoints JSON-RPC publics pour le mainnet et le testnet. La documentation BNB Chain indique une limite de 10 000 requêtes par 5 minutes, et précise que eth_getLogs est désactivé sur les endpoints publics du mainnet.

Pour des prototypes et des lectures occasionnelles, cela suffit. Pour un service qui surveille de nombreuses adresses, il vous faut soit votre propre nœud, soit un fournisseur, soit une API qui vous pousse les événements. Pour la voie du nœud, voir comment dialoguer avec un nœud en JSON-RPC. Davantage d’informations côté Chaingateway figurent sur la page API BSC.

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 Binance Smart Chain 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.