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.
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:
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.