← Blog
10 min de lectura
|
Publicado
|
Actualizado

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.

Capítulos
C
Chaingateway Team
Expertos en blockchain

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 cadenasInterfaz nativaQué gestiona usted mismo
Ethereum, BNB Smart Chain, Polygon, ArbitrumJSON-RPC en su propio nodo o en un endpoint alojadoCantidades codificadas en hexadecimal, decodificación ABI de transferencias de tokens, ajustes de gas
BitcoinRPC de Bitcoin CoreGestión de UTXO, estimación de comisiones, archivos de wallet
Troninterfaces del nodo java-tron, HTTP y plug-ins de eventosRecursos 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:

Terminal window
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:

  1. Cree una dirección para el pedido o el usuario: POST /api/v2/ethereum/addresses con un password. La respuesta contiene la nueva dirección.
  2. Registre un webhook para esa dirección con POST /api/v2/ethereum/webhooks, con la URL de su receptor en url.
  3. Muestre la dirección al pagador.
  4. 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.
  5. Reenvíe los fondos con POST /api/v2/ethereum/transactions, o con .../transactions/erc20 para 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.

C
Chaingateway Team
Expertos en blockchain

El equipo de Chaingateway se dedica a simplificar la integración blockchain para desarrolladores de todo el mundo.