Cette page s'applique à Apigee et à Apigee hybrid.
Consultez la documentation d'Apigee Edge.
En tant que fournisseur d'API, vous avez développé un ensemble d'API pour permettre l'accès à vos services de backend. L'étape suivante consiste à créer votre portail des développeurs pour permettre aux développeurs d'applications d'effectuer les opérations suivantes :
- Obtenir des informations sur vos données et vos offres de services
- Découvrir comment utiliser vos API en consultant la documentation complète, y compris un exemple de cas d'utilisation, des tutoriels et une documentation de référence.
- S'inscrire à l'aide d'un processus en libre-service afin de créer des applications utilisant vos API.
Apigee est compatible avec plusieurs solutions de portail des développeurs, résumées dans le tableau suivant, allant de la solution clé en main simple à une personnalisation complète et extensible. Lorsque vous choisissez une solution, vous devez équilibrer vos exigences de personnalisation en fonction du temps et des connaissances nécessaires pour mettre en œuvre votre portail.
| Solution Apigee | Fonctionnalités | Hébergé par Apigee ? | Assistance (nécessite un abonnement sous licence). |
|---|---|---|---|
| Portail intégré Apigee | Développement simple pour un portail en libre-service. | Oui | Assistance 24h/24, 7j/7 Apigee |
| Modules Drupal 10 | Une option entièrement personnalisable, basée sur un puissant CMS Open Source intégré à Apigee à l'aide de modules. | Non | Assistance Apigee 24 h/24, 7 j/7 pour les problèmes de dépannage |
| Bricolage | Développement de portail entièrement personnalisable à l'aide des API Apigee. | Non | Assistance Apigee 24h/24, 7j/7 pour les API Apigee uniquement |
Choisir la solution de portail des développeurs
Pour vous aider à choisir votre solution de portail des développeurs, tenez compte de l'arbre de décision ci-dessous et consultez la page Comparaison des fonctionnalités du portail des développeurs.
Pensez à créer un portail intégré Apigee si vous envisagez d'accepter des cas d'utilisation courants pour le développement d'un portail, tels que des flux d'enregistrement et de création d'application standards, et des modifications portant plus sur le style que les fonctionnalités.
Comparaison des fonctionnalités des portails de développeurs
Le tableau suivant compare les fonctionnalités du portail intégré d'Apigee et du portail de développeurs basé sur Drupal.
| Fonctionnalité | Portail intégré | Drupal |
|---|---|---|
| Développement de contenu de portail à l'aide de Markdown | ||
| Développement de contenu de portail avec HTML | ||
| Documentation de référence de l'API affichée à partir des spécifications OpenAPI | ||
| Compatibilité de la spécification OpenAPI version 3 | ||
| Envoyer des demandes en direct à partir de votre référence d'API | ||
| Conformité FedRAMP | En tant que solution CMS Open Source entièrement personnalisable, il est possible de mettre en œuvre un portail Drupal conforme au programme FedRamp. | |
| Thème personnalisé | ||
| Menus personnalisés | ||
| Balises tierces, telles que Google Analytics | ||
| Code JavaScript personnalisé | ||
| Nom du domaine personnalisé | ||
| HTTPS activé | ||
| Conditions d'utilisation pour la création d'un compte | ||
| Optimisation de l'affichage sur les appareils mobiles | ||
| Intégration avec des scripts et des balises de script personnalisés | ||
| Configuration SMTP | ||
| Configuration du modèle d'e-mail | ||
| CAPTCHA pour éviter le spam | ||
| Rôles et autorisations pour les comptes de développeur/consommateur | ||
| Connexion fédérée | ||
| API de gestion de contenu | Utiliser Drupal | |
| Monétisation | ||
| Configuration de la recherche | * | |
| Blog et forums | ** | |
| Modèles de pages pour la création de contenu | ||
| Analyse des applications sur le portail | ||
| Gestion des événements basée sur des règles | ||
| Extensible avec des modules complémentaires | ||
| Flux d'enregistrement des applications personnalisées | ||
| Flux d'enregistrement des développeurs personnalisés | ||
| Journaux du portail | ||
| Vérification des liens | ||
| Compatibilité avec Microsoft Internet Explorer/Microsoft Edge | Microsoft Edge uniquement | |
| Hébergement régional | États-Unis uniquement | (Solution personnalisée : vous pouvez héberger un portail Drupal dans la ou les régions de votre choix.) |
Créer un portail intégré
Créez rapidement un portail de développeurs léger dans l'UI Apigee. Accédez à la page https://apigee.google.com, connectez-vous et sélectionnez Publier > Portails dans la barre de navigation latérale de l'interface utilisateur hybride. Pour en savoir plus, consultez la page Créer votre portail intégré.
La figure suivante présente la page de destination du portail intégré.
Créer un portail basé sur Drupal
À l'aide des outils de développement du portail Drupal, vous pouvez créer un portail des développeurs entièrement personnalisable. Drupal offre une large gamme de fonctionnalités, ainsi que toutes les fonctionnalités CMS de Drupal avec des modules Drupal supplémentaires développés par Apigee. La mise en œuvre d'un portail basé sur Drupal nécessite cependant plus de temps et d'efforts.
Apigee et Apigee hybrid sont compatibles avec Drupal 10, qui fournit un système de gestion de contenu (CMS) Open Source fiable de niveau entreprise. Étant donné que Drupal 10 est Open Source, vous pouvez étendre le framework de développement du portail Drupal 10 et y contribuer et tirer parti des connaissances de la communauté Drupal. Pour plus d'informations, consultez la section Créer votre portail à l'aide de Drupal 10.
Créer votre propre portail à l'aide des API Apigee
Créez votre propre portail entièrement personnalisé en tirant parti des API Apigee résumées dans le tableau suivant. Pour en savoir plus, reportez-vous aux sections décrites dans le tableau suivant.
| Catégorie | API Apigee | Description |
| Analytics | Stats | Affichez les données analytiques de vos API. |
| Clés API | Clés d'application de développer | Gérez les clés API utilisées pour autoriser l'utilisation des API dans les applications. |
| Produits d'API | Produits d'API | Gérez les produits d'API que vous publiez sur le portail des développeurs. |
| Applications | Applications | Gérez les applications enregistrées par les développeurs pour utiliser vos API. |
| Développeurs | Développeurs | Gérez les développeurs qui se sont enregistrés sur votre portail des développeurs. |
Simplifiez l'intégration du client de votre portail à l'aide de la bibliothèque cliente Apigee pour PHP. Le SDK facilite l'écriture de modules PHP utilisant les API Apigee décrites dans le tableau précédent. Pour en savoir plus sur la bibliothèque cliente des API Apigee pour PHP, consultez les sections suivantes :