Passerelle d'API

Oracle Blockchain Platform Digital Assets Edition utilise le service de passerelle d'API pour déployer les API d'encapsulation générées par Blockchain App Builder.

Les points d'extrémité d'API Wrapper sont publiés sur la passerelle d'API à l'aide d'une pile du gestionnaire de ressources sur Oracle Cloud Infrastructure (OCI). Les piles déploient et gèrent des groupes de ressources en nuage d'une manière prédéfinie et reproductible, ce qui peut simplifier l'orchestration et l'automatisation du provisionnement de l'infrastructure. Le service de passerelle d'API OCI vous permet de publier des API avec des points d'extrémité privés qui sont accessibles depuis votre réseau, mais que vous pouvez exposer avec des adresses IP publiques si vous souhaitez qu'elles acceptent le trafic Internet.

L'API REST d'Oracle Blockchain Platform exige que vous transmettiez des paramètres tels que le nom du code de chaîne, la temporisation et les valeurs de synchronisation, ainsi que des arguments, y compris le nom de la méthode chaque fois que vous appelez l'API. Dans les scénarios où les paramètres sont communs à toutes les méthodes, vous pouvez utiliser des API wrapper pour appeler l'API en utilisant uniquement les arguments de méthode. Chaque méthode de code de chaîne aura un point d'extrémité d'API d'encapsulation distinct. Dans certains cas, plusieurs points d'extrémité d'API REST provenant de différents codes de chaîne et points d'extrémité Oracle Identity Cloud Service peuvent être fusionnés pour former un seul point d'extrémité d'API d'encapsulation.

L'exemple suivant montre comment appeler la méthode associateTokenToAccount avec Oracle Blockchain Platform.

Point d'extrémité : 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}}
}

Avec les API wrapper prises en charge par Oracle Blockchain Platform Digital Assets Edition, le même appel ressemble à l'exemple suivant :

Point d'extrémité : https://<gateway-hostname>/<deployment-path-prefix>/<route-path>

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

La passerelle d'API est configurée dans le cadre d'un déploiement de pile lorsque vous déployez des API d'encapsuleur. Pour plus d'informations sur le déploiement des API d'encapsuleur, voir Déployer des API d'encapsuleur dans Blockchain App Builder pour Oracle Blockchain Platform.