Gateway de API

Oracle Blockchain Platform Digital Assets Edition utiliza el servicio API Gateway para desplegar las API de envoltorio generadas por Blockchain App Builder.

Los puntos finales de la API de envoltorio se publican en API Gateway mediante una pila de Resource Manager en Oracle Cloud Infrastructure (OCI). Las pilas despliegan y gestionan grupos de recursos en la nube de forma predefinida y repetible, lo que puede simplificar la orquestación y automatización del aprovisionamiento de infraestructura. El servicio de gateway de API de OCI le permite publicar API con puntos finales privados accesibles desde la red y que se pueden exponer con direcciones IP públicas si desea que acepten tráfico de Internet.

Los puntos finales de la API de REST de Oracle Blockchain Platform requieren que transfiera parámetros como el nombre del código de cadena, los valores de timeout y sincronización, y argumentos que incluyan el nombre del método cada vez que llame a la API. En casos en los que los parámetros son comunes a todos los métodos, puede utilizar las API de envoltorio para llamar a la API utilizando solo los argumentos del método. Cada método de código de cadena tendrá un punto final de API de encapsulador distinto. En algunos casos, se pueden fusionar varios puntos finales de API de REST de diferentes códigos de cadena y también puntos finales de Oracle Identity Cloud Service para formar un único punto final de API de encapsulador.

En el siguiente ejemplo se muestra cómo llamar al método associateTokenToAccount con Oracle Blockchain Platform.

Punto final: https://<blockchain_instance>:7443/restproxy/api/v2/channels/<channelName>/transactions

{
    "chaincode": "{{bc-chaincode-name}}",
    "args": [
        "associateTokenToAccount",
        "oaccount~78b47483e4033a0c6be3b678080264e7967d53f56d4b024edd96eb8957c452d4",
        "t2"
    ],
    "timeout": {{bc-timeout}},
    "sync": {{bc-sync}}
}

Con las API de envoltorio soportadas por Oracle Blockchain Platform Digital Assets Edition, la misma llamada se parece al siguiente ejemplo:

Punto final: https://<gateway-hostname>/<deployment-path-prefix>/<route-path>

{
 "accountId":"oaccount~efc22a0316a47dd06679920140717b686c7366a627a707c5e8c89015bb21796a",
 "tokenId":"t1"
}

El gateway de API se configura como parte de un despliegue de pila al desplegar API de envoltorio. Para obtener más información sobre el despliegue de API de envoltorio, consulte Despliegue de API de envoltorio en Blockchain App Builder para Oracle Blockchain Platform.