API de blockchain: qué hace y por qué usar una
Una API de blockchain permite leer cadenas y enviar transacciones por HTTPS sin nodos propios. Qué cubre, cómo funciona la autenticación y dónde termina.
Revisado por Maurice Sobiera
Una API de blockchain es una interfaz web que permite a su software leer datos de la blockchain y enviar transacciones sin ejecutar un nodo. Usted envía peticiones HTTPS y recibe JSON, en lugar de hablar el protocolo nativo de cada cadena. La API de Chaingateway cubre Bitcoin, Ethereum, Tron, BNB Smart Chain, Polygon, Arbitrum y Solana tras un único esquema de autenticación.
¿Por qué necesitan las blockchains una capa de API?
Cada cadena tiene su propia interfaz nativa, y ninguna está pensada para desarrolladores de aplicaciones. Un nodo expone métodos de bajo nivel, codificaciones en bruto y su propio formato de direcciones. La tabla muestra por dónde empieza un desarrollador sin una capa de API.
| Familia de cadenas | Interfaz nativa | Qué gestiona usted mismo |
|---|---|---|
| Ethereum, BNB Smart Chain, Polygon, Arbitrum | JSON-RPC en su propio nodo o en un endpoint alojado | Cantidades codificadas en hexadecimal, decodificación ABI de transferencias de tokens, ajustes de gas |
| Bitcoin | RPC de Bitcoin Core | Gestión de UTXO, estimación de comisiones, archivos de wallet |
| Tron | interfaces del nodo java-tron, HTTP y plug-ins de eventos | Recursos de energía y ancho de banda, transacciones basadas en protobuf |
Una capa de API pone un único estilo de petición encima de estas interfaces. Crear una dirección es POST /api/v2/<chain>/addresses en Ethereum, BNB Smart Chain, Polygon, Arbitrum, Tron y Solana. Bitcoin usa wallets, que se crean con POST /api/v2/bitcoin/wallets. Las transferencias de tokens siguen el mismo patrón en todas las cadenas que tienen tokens. Las diferencias que quedan son diferencias reales entre cadenas, como los recursos de Tron o las comisiones de Bitcoin. El artículo API de blockchain frente a nodo compara ambas vías con más detalle.
¿Qué puede hacer con una API de blockchain?
Puede crear direcciones, enviar monedas nativas y tokens, leer bloques y transacciones, y recibir notificaciones. En la referencia de la API de Chaingateway, estos son los grupos principales:
- Direcciones: crear (con o sin contraseña que cifre la clave), importar y listar direcciones
- Transacciones: enviar moneda nativa, tokens ERC20/TRC20/BEP20 y NFT ERC721, y leer transacciones
- Datos de red: número del último bloque y precio del gas en las cadenas EVM
- Webhooks: registrar una dirección y una URL, y recibir un POST cuando ocurre una transacción coincidente
- Solo en Tron: congelar y delegar recursos para energía y ancho de banda
No todas las cadenas tienen todos los grupos. Solana no tiene webhooks, por ejemplo. El archivo OpenAPI enumera exactamente qué endpoints existen para cada cadena.
¿Cómo funciona la autenticación?
Cada petición lleva un token portador en la cabecera Authorization, según define la RFC 6750. La red principal es la predeterminada. Para usar una red de pruebas, añada la cabecera X-Network: testnet:
curl https://app.chaingateway.io/api/v2/ethereum/blocks/number \ -H "Authorization: Bearer $CHAINGATEWAY_TOKEN" \ -H "X-Network: testnet"La misma llamada sin la segunda cabecera devuelve el último bloque de la red principal. Las redes de prueba son Sepolia para Ethereum, Nile para Tron, Amoy para Polygon y Devnet para Solana, entre otras. La lista completa está en la página de redes compatibles. Guarde el token en su servidor. Cualquiera que lo tenga puede usar su cuenta.
¿Qué casos de uso encajan con una API de blockchain?
Aceptar pagos, vigilar depósitos y distribuir tokens son los habituales. Una tienda asigna a cada pedido su propia dirección y registra un webhook para ella. Un exchange o un servicio de wallets hace lo mismo con los depósitos de sus usuarios. Un proyecto que paga tokens a muchos destinatarios envía una solicitud de transferencia por cada destinatario. El artículo sobre cadenas de suministro recorre un flujo de pago con referencia de factura.
Versiones anteriores de este artículo enumeraban también las aplicaciones descentralizadas, la verificación de identidad y la creación de contratos inteligentes como funciones de la API. La API no despliega contratos inteligentes, y la verificación de identidad no forma parte de ella. La lógica propia de una dApp vive en contratos que usted despliega con otras herramientas. La API es el medio por el que su servidor se comunica con la cadena alrededor de ellos.
¿Cómo es una integración?
Una integración de pagos tiene cinco pasos, y cada uno es una sola petición:
- Cree una dirección para el pedido o el usuario:
POST /api/v2/ethereum/addressescon unpassword. La respuesta contiene la nueva dirección. - Registre un webhook para esa dirección con
POST /api/v2/ethereum/webhooks, con la URL de su receptor enurl. - Muestre la dirección al pagador.
- Su receptor recibe un POST con el ID de la transacción, el remitente, el destinatario, el número de bloque y el tipo. Responde con un estado de éxito.
- Reenvíe los fondos con
POST /api/v2/ethereum/transactions, o con.../transactions/erc20para un token.
Pruebe primero los cinco pasos con X-Network: testnet. Las monedas de testnet no tienen valor, así que un error no cuesta nada.
¿Qué no hace una API de blockchain?
No cambia el funcionamiento de la cadena. Límites que debe tener en cuenta:
- Una transacción puede seguir fallando, por ejemplo por falta de gas. El tiempo de confirmación lo fija la cadena, no la API.
- Los webhooks no se reintentan automáticamente. Las notificaciones fallidas se enumeran, y usted pide que se vuelvan a enviar.
- Las claves requieren cuidado. Una wallet creada sin contraseña devuelve su clave privada en la respuesta. Con contraseña, la clave se almacena cifrada en el lado de Chaingateway. Chaingateway no guarda la contraseña, así que si la contraseña se pierde, la wallet no puede restaurarse.
- Un proveedor sigue siendo una dependencia. Mantenga sus propios registros de cada ID de transacción que cree.
Cómo escribimos estos artículos
¿Listo para construirlo tú mismo? Obtenga su clave de API — prueba de 7 días, sin tarjeta — o consulte API Blockchain para la referencia completa de los endpoints.