Guide pratique pour créer une API de gestion des ressources de base avec Azure Functions

Cet article vous guide tout au long de la création d’une API fictive de base pour une application de gestion des ressources à l’aide de Azure Functions. L’API expose une seule opération pour retourner une liste de ressources. Vous allez également apprendre à créer un connecteur personnalisé dans Power Platform à l'aide de API Management.

Cette API de base fournit une liste de ressources factices et est prête à être intégrée à Power Platform à l’aide d’un connecteur personnalisé via Gestion des API.

Prerequisites

• Accès au portail Azure
• Environnement Power Platform avec des applications de code activées

Créer une fonction Azure dans le portail Azure

1. Accédez au Portail Azure.

2. Sélectionnez Créer une ressource>Application de fonction Web>.

3. Sélectionnez Consommation.

4. Renseignez les détails requis :

   Détails	Description
   Abonnement	Sélectionnez votre abonnement
   Groupe de ressources	Créez-en un ou utilisez-en un existant
   Nom de l’application de fonction	Choisir un nom unique
   Pile d’exécution	Node.js
   Région	Choisir une région proche de vous

5. Sélectionnez Vérifier + créer, puis Créer.

   

6. Une fois le déploiement terminé, accédez à votre nouvelle application de fonction.

7. Sélectionnez Créer une fonction.

8. Si vous y êtes invité, sélectionnez : Environnement de développement : Développer dans le portail.

9. Sélectionnez le déclencheur HTTP comme modèle, attribuez-lui le nom GetAssetset définissez le niveau d’autorisationsur Anonyme , car aucune authentification n’est requise dans cet exemple de base.

   

10. Sélectionnez Créer pour créer la fonction.

11. Sous l’onglet Code + Test , remplacez le code de fonction par le code d’API fictif de la section suivante.

12. Cliquez sur Enregistrer.

Implémenter l’API fictive

Modifiez GetAssets/index.js pour retourner une liste factice des ressources :

module.exports = async function (context, req) {
    context.res = {
        // status: 200, /* Defaults to 200 */
        body: [
            { id: 1, name: "Laptop", type: "Electronics", status: "Available" },
            { id: 2, name: "Projector", type: "Electronics", status: "In Use" },
            { id: 3, name: "Desk", type: "Furniture", status: "Available" },
            { id: 4, name: "Office Chair", type: "Furniture", status: "In Use" },
            { id: 5, name: "Monitor", type: "Electronics", status: "Available" },
            { id: 6, name: "Whiteboard", type: "Office Supply", status: "Available" },
            { id: 7, name: "Phone", type: "Electronics", status: "In Use" },
            { id: 8, name: "Tablet", type: "Electronics", status: "Available" },
            { id: 9, name: "Printer", type: "Electronics", status: "Maintenance" },
            { id: 10, name: "Filing Cabinet", type: "Furniture", status: "Available" }
        ]
    };
};

Exposez votre application fonctionnelle via la gestion des API

1. Dans le portail Azure, recherchez et sélectionnez API Management services.

2. Sélectionnez + Créer pour créer une instance Gestion des API. Le niveau Développeur est gratuit pour le développement/test.

3. Renseignez les détails requis et déployez l’instance.

4. Une fois déployé, ouvrez votre instance Gestion des API.

5. Dans le menu de gauche, sélectionnez APIs>+ Ajouter API>Application de Fonctions.

   

6. Sélectionnez votre Function App et la fonction GetAssets.

   

7. Terminez l’Assistant pour importer votre fonction en tant qu’opération d’API.

8. Après l’importation, accédez à votre API dans Gestion des API.

9. Dans le menu supérieur, sélectionnez Paramètres de votre API.

10. Sous Sécurité, définissez Abonnement requis sur Désactivé. Cela supprime la nécessité d’une clé d’abonnement (clé API) lors de l’appel de l’API.

    

11. Enregistrez vos modifications.

Créer un connecteur personnalisé dans Power Platform à l’aide de la gestion des API (à partir du portail Azure)

1. Dans API Management Services Dans le menu de gauche dans les API, sélectionnez Power Platform.

2. Sélectionnez Créer un connecteur.

3. Sélectionnez votre API :

   

4. Sélectionnez votre environnement et votre nom d’affichage, puis sélectionnez Créer. Le connecteur personnalisé est créé dans votre environnement sélectionné.

5. Dans Power Apps, accédez aux connecteurs personnalisés pour passer en revue, modifier et tester votre nouveau connecteur.

   

Étapes suivantes

• Créez une nouvelle application codée à l’aide de ce connecteur personnalisé avec la bibliothèque cliente Power Apps pour applications codées.
• Développez l’API avec plus d’opérations si nécessaire. N'oubliez pas de mettre à jour le connecteur avec les nouvelles opérations lorsque vous effectuez ces modifications.
• Sécurisez votre API si vous passez au-delà du développement/test.