Générer des API d'encapsuleur à l'aide de Visual Studio Code

La version améliorée de Blockchain App Builder vous permet de générer des API de wrapper dans Visual Studio Code.

Lorsque vous générez des API d'encapsuleur dans Visual Studio Code, vous êtes invité à remplacer les ensembles d'API d'encapsuleur précédents qui existent dans l'emplacement de sélection.

Le service de passerelle d'API limite à 50 le nombre de routes pouvant être créées dans un seul déploiement. Si vous essayez de générer plus de 50 API wrapper, vous êtes invité à créer plusieurs passerelles. La création de plusieurs passerelles avec le même préfixe de chemin de déploiement maintient un chemin de base cohérent entre tous les points d'extrémité d'API d'encapsulation. Si vous choisissez de ne pas créer plusieurs passerelles, la génération de l'API d'encapsulation est annulée. Vous pouvez également réutiliser des passerelles existantes, comme décrit dans les étapes suivantes.

  1. Sélectionnez le projet de code de chaîne dans le volet Codes de chaîne.
  2. Cliquez avec le bouton droit de la souris sur le nom du code de chaîne, puis sélectionnez Générer un ensemble d'API d'encapsulation. Le volet Oracle Blockchain Platform - Wrapper API Package Generation s'ouvre.
  3. Entrez les variables de configuration décrites dans le tableau suivant.
    Champ Description Valeur par défaut
    OCID du compartiment. OCID du compartiment dans Oracle Cloud Infrastructure (OCI). aucune
    Nom du compartiment Nom du compartiment OCI. aucune
    Domaine d'identité Domaine d'identité à utiliser. aucune
    Canal de chaîne de blocs Nom du canal Oracle Blockchain Platform où le code de chaîne est déployé. aucune
    URL de chaîne de blocs URL d'Oracle Blockchain Platform associée au déploiement du code de chaîne. aucune
    Emplacement Répertoire système dans lequel générer le paquetage d'API d'encapsulation. aucune
    Nouvelle passerelle d'API Pour créer des passerelles d'API, sélectionnez Oui, puis spécifiez un nom d'affichage de la passerelle. Pour réutiliser des passerelles d'API existantes, sélectionnez Non, puis spécifiez un tableau d'identificateurs Oracle Cloud (OCID) pour les passerelles d'API existantes à réutiliser dans le format suivant. Vous devez spécifier une passerelle pour chaque 50 API d'encapsuleur. 
    ["ocid1.apigateway.xxx", "ocid1.apigateway.yyy"]
    		 Oui
    Préfixe de chemin de déploiement Préfixe du chemin de déploiement dans la passerelle d'API, qui spécifie le chemin où les routes sont déployées. Le préfixe du chemin de déploiement doit commencer par une barre oblique (/). /<ChaincodeName>
    Synchronisation de chaîne de blocs Valeur de synchronisation à inclure dans les données utiles pour les appels d'API. true
    Temporisation de la chaîne de blocs Valeur de temporisation à inclure dans les données utiles pour les appels d'API. 6,000
    Nom de politique Nom de la politique qui permet la gestion contrôlée et l'accès aux API au moyen d'autorisations définies pour les groupes et les compartiments de l'organisation. ChaincodeName
    Nom d'affichage du réseau en nuage virtuel Nom d'affichage du réseau en nuage virtuel OCI. ChaincodeName
    Nom d'affichage de l'application Nom d'affichage de l'application OCI. ChaincodeName
    Nom d'affichage de la passerelle Nom d'affichage de la passerelle d'API. ChaincodeName
    Nom d'affichage du déploiement Nom d'affichage de la passerelle d'API. ChaincodeName
    Nom du référentiel OCI Nom du référentiel du registre OCI, qui doit être en minuscules. ChaincodeName en minuscules
  4. Cliquez sur Enregistrer.
  5. Cliquez sur l'onglet Mappage. Le volet Mappage présente un tableau de toutes les API de contrôleur disponibles dans le code de chaîne. Chaque méthode a un point d'extrémité d'API correspondant, que vous pouvez modifier selon vos besoins. Cochez la case Générer les API d'encapsuleur correspondante pour inclure l'API de contrôleur dans l'ensemble d'API d'encapsulation. Cliquez sur Tout sélectionner pour inclure toutes les API de contrôleur.
  6. Cliquez sur Enregistrer.
  7. Cliquez sur Générer. L'ensemble API wrapper et la collection Postman associée sont générés.