Gateway API

Oracle Blockchain Platform Digital Assets Edition utilizza il servizio API Gateway per distribuire le API wrapper generate da Blockchain App Builder.

Gli endpoint API wrapper vengono pubblicati sul gateway API utilizzando uno stack Resource Manager su Oracle Cloud Infrastructure (OCI). Gli stack distribuiscono e gestiscono gruppi di risorse cloud in modo predefinito e ripetibile, il che può semplificare l'orchestrazione e l'automazione del provisioning dell'infrastruttura. Il servizio OCI API Gateway ti consente di pubblicare API con endpoint privati accessibili dall'interno della tua rete e che puoi esporre con indirizzi IP pubblici se vuoi che accettino il traffico Internet.

Gli endpoint delle API REST di Oracle Blockchain Platform richiedono di passare parametri quali il nome del codice concatenato, i valori di timeout e sincronizzazione, nonché argomenti che includono il nome del metodo ogni volta che si chiama l'API. Negli scenari in cui i parametri sono comuni a tutti i metodi, è possibile utilizzare le API wrapper per chiamare l'API utilizzando solo gli argomenti del metodo. Ogni metodo di codice concatenato avrà un endpoint API wrapper distinto. In alcuni casi, è possibile unire più endpoint API REST da codici concatenati diversi e anche gli endpoint di Oracle Identity Cloud Service per formare un singolo endpoint API wrapper.

L'esempio seguente mostra la chiamata del metodo associateTokenToAccount con Oracle Blockchain Platform.

Endpoint: 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 le API wrapper supportate da Oracle Blockchain Platform Digital Assets Edition, lo stesso richiamo assomiglia all'esempio riportato di seguito.

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

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

Il gateway API viene configurato come parte di una distribuzione dello stack durante la distribuzione delle API wrapper. Per ulteriori informazioni sulla distribuzione delle API wrapper, vedere Distribuisci API wrapper in Blockchain App Builder for Oracle Blockchain Platform.