Passerelle d'API

Oracle Blockchain Platform Digital Assets Edition utilise le service API Gateway pour déployer des API de wrapper générées par Blockchain App Builder.

Les adresses d'API de wrapper sont publiées sur API Gateway à l'aide d'une pile Resource Manager sur Oracle Cloud Infrastructure (OCI). Les piles déploient et gèrent des groupes de ressources cloud de manière prédéfinie et reproductible, ce qui peut simplifier l'orchestration et l'automatisation du provisionnement de l'infrastructure. Le service OCI API Gateway vous permet de publier des API avec des adresses privées accessibles à partir de votre réseau. Si vous voulez qu'elles acceptent le trafic Internet, vous pouvez les exposer avec des adresses IP publiques.

Les adresses d'API REST Oracle Blockchain Platform nécessitent que vous transmettiez des paramètres tels que le nom de code chaîne, le délai d'expiration et les valeurs de synchronisation, ainsi que des arguments tels que le nom de méthode à chaque appel de l'API. Dans les scénarios où les paramètres sont communs à toutes les méthodes, vous pouvez utiliser des API de wrapper pour appeler l'API en utilisant uniquement les arguments de méthode. Chaque méthode de code chaîne dispose d'une adresse d'API de wrapper distincte. Dans certains cas, plusieurs adresses d'API REST à partir de différents codes chaîne et également des adresses Oracle Identity Cloud Service peuvent être fusionnées pour former une seule adresse d'API de wrapper.

L'exemple suivant illustre l'appel de la méthode associateTokenToAccount avec Oracle Blockchain Platform.

Adresse : 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 de wrapper prises en charge par Oracle Blockchain Platform Digital Assets Edition, le même appel ressemble à l'exemple suivant :

Adresse : https://<gateway-hostname>/<deployment-path-prefix>/<route-path>

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

API Gateway est configuré dans le cadre d'un déploiement de pile lorsque vous déployez des API de wrapper. Pour plus d'informations sur le déploiement des API de wrapper, reportez-vous à Déploiement des API de wrapper dans Blockchain App Builder pour Oracle Blockchain Platform.