Solutions du portail des développeurs

Vous consultez la documentation d'Apigee X.
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 8/9 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.

Organigramme illustrant comment choisir entre le portail Drupal et le portail intégré Apigee

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
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
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

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/edge, 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é.

Présentation du portail

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.

Hybrid est compatible avec Drupal 8 et 9, qui fournissent un système de gestion de contenu (CMS) Open Source fiable de niveau entreprise. Étant donné que Drupal 8/9 est Open Source, vous pouvez étendre le framework de développement du portail Drupal 8/9, y contribuer et bénéficier des connaissances de la communauté Drupal. Pour en savoir plus, consultez la page Créer votre portail avec Drupal 8/9.

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

Applications développeur

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 :