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, além de argumentos que incluem o nome do método toda vez que você 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 chaincode terá um ponto final de API wrapper distinto. Em alguns casos, vários pontos finais da API REST de diferentes chaincodes e também pontos finais do Oracle Identity Cloud Service podem ser mesclados para formar um único ponto final da 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/<channelName>/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://<gateway-hostname>/<deployment-path-prefix>/<route-path>
{
 "accountId":"oaccount~efc22a0316a47dd06679920140717b686c7366a627a707c5e8c89015bb21796a",
 "tokenId":"t1"
}

O Gateway de API é configurado como parte de uma implantação de pilha quando você implanta APIs wrapper. Para obter mais informações sobre como implantar APIs do wrapper, consulte Implantar APIs do Wrapper no Blockchain App Builder para Oracle Blockchain Platform.