API-Gateway

Oracle Blockchain Platform Digital Assets Edition verwendet den API-Gateway-Service, um von Blockchain App Builder generierte Wrapper-APIs bereitzustellen.

Wrapper-API-Endpunkte werden mit einem Resource Manager-Stack auf Oracle Cloud Infrastructure (OCI) auf API Gateway veröffentlicht. Stacks stellen Gruppen von Cloud-Ressourcen auf vordefinierte und wiederholbare Weise bereit und verwalten sie, was die Orchestrierung und Automatisierung der Infrastrukturbereitstellung vereinfachen kann. Mit dem OCI-API-Gateway-Service können Sie APIs mit privaten Endpunkten veröffentlichen, auf die Sie über Ihr Netzwerk zugreifen können. Sie können aber auch öffentliche IP-Adressen angeben, wenn Internettraffic akzeptiert werden soll.

Für Oracle Blockchain Platform-REST-API-Endpunkte müssen Sie bei jedem Aufruf der API Parameter wie den Chaincodenamen, Timeout- und Synchronisierungswerte sowie Argumente übergeben, einschließlich des Methodennamens. In Szenarios, in denen die Parameter allen Methoden gemeinsam sind, können Sie die API mit Wrapper-APIs nur mit den Methodenargumenten aufrufen. Jede Chaincode-Methode verfügt über einen eindeutigen Wrapper-API-Endpunkt. In einigen Fällen können mehrere REST-API-Endpunkte aus verschiedenen Chaincodes und auch Oracle Identity Cloud Service-Endpunkte zu einem einzelnen Wrapper-API-Endpunkt zusammengeführt werden.

Das folgende Beispiel zeigt den Aufruf der Methode associateTokenToAccount mit Oracle Blockchain Platform.

Endpunkt: 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}}
}

Mit den von Oracle Blockchain Platform Digital Assets Edition unterstützten Wrapper-APIs sieht derselbe Aufruf wie im folgenden Beispiel aus:

Endpunkt: https://<blockchain_instance>/appbuilder/associate
{
 "accountId":"oaccount~efc22a0316a47dd06679920140717b686c7366a627a707c5e8c89015bb21796a",
 "tokenId":"t1"
}

API Gateway wird als Teil eines Stack-Deployments konfiguriert, wenn Sie Ihre Wrapper-APIs bereitstellen, wie unter Wrapper-APIs bereitstellen beschrieben.