Gateway de API

A Edição de Ativos Digitais do Oracle Blockchain Platform usa o serviço API Gateway para implantar APIs wrapper geradas pelo Blockchain App Builder.

Os pontos finais da API do Wrapper são publicados no Gateway de API usando uma pilha do Resource Manager no OCI (Oracle Cloud Infrastructure). As pilhas implementam e gerenciam grupos de recursos de nuvem de maneira predefinida e repetível, o que pode simplificar a orquestração e a automação do provisionamento de infraestrutura. O serviço OCI API Gateway permite que você publique APIs com pontos finais privados acessíveis na sua rede e que você pode expor com endereços IP públicos se quiser que eles aceitem o tráfego da internet.

Os pontos finais da API REST do Oracle Blockchain Platform exigem que você informe parâmetros como nome do chaincode, valores de timeout e sincronização e argumentos, incluindo o nome do método toda vez que chamar a API. Em cenários em que os parâmetros são comuns a todos os métodos, você pode usar APIs wrapper para chamar a API usando apenas os argumentos do método. Cada método de chaincode terá um ponto final de API de encapsulador distinto. Em alguns casos, vários pontos finais de API REST de diferentes chaincodes e também pontos finais do Oracle Identity Cloud Service podem ser mesclados para formar um único ponto final de API wrapper.

O exemplo a seguir mostra como chamar o método associateTokenToAccount com o Oracle Blockchain Platform.

Ponto final: https://<blockchain_instance>:7443/restproxy/api/v2/channels/default/transactions

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

Com as APIs wrapper suportadas pela Edição de Ativos Digitais do Oracle Blockchain Platform, a mesma chamada se parece com o seguinte exemplo:

Ponto final: https://<blockchain_instance>/appbuilder/associate

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

O Gateway de API é configurado como parte de uma implantação de pilha quando você implanta suas APIs do wrapper, conforme descrito em Implantar APIs do Wrapper.