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 REST-API-Endpunkte von Oracle Blockchain Platform müssen Sie Parameter wie Chaincode-Name, Timeout und Synchronisierungswerte sowie Argumente übergeben, einschließlich des Methodennamens, jedes Mal, wenn Sie die API aufrufen. In Szenarios, in denen die Parameter allen Methoden gemeinsam sind, können Sie Wrapper-APIs verwenden, um die API nur mit den Methodenargumenten aufzurufen. Jede Chaincode-Methode hat 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/<channelName>/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://<gateway-hostname>/<deployment-path-prefix>/<route-path>

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

API Gateway wird als Teil eines Stack-Deployments konfiguriert, wenn Sie Wrapper-APIs bereitstellen. Weitere Informationen zum Deployment von Wrapper-APIs finden Sie unter Wrapper-APIs bereitstellen in Blockchain App Builder for Oracle Blockchain Platform.