*This page
applies to **Apigee** and **Apigee hybrid**.*


*View [Apigee Edge](https://docs.apigee.com/api-platform/get-started/what-apigee-edge) documentation.*
![](https://fonts.gstatic.com/s/i/googlematerialicons/help/v13/gm_grey-24dp/1x/gm_help_gm_grey_24dp.png)

As an API provider, you have developed a set of APIs to provide access to your backend services.
Your next step is to build your **developer portal** to enable app developers to:

- Learn about your data and service offerings
- Learn how to use your APIs by reviewing comprehensive documentation, including example use case, tutorials, and reference documentation
- Register using a self-service process in order to build apps that use your APIs

Apigee supports several developer portal solutions, summarized in the following table, ranging
from simple turn-key to fully customizable and extensible. When choosing a solution, you need to
balance your customization requirements against the time and knowledge required to implement your
portal.

| Apigee solution | Features | Hosted by Apigee? | Support (Requires licensed subscription) |
|---|---|---|---|
| [Apigee integrated portal](https://docs.cloud.google.com/apigee/docs/api-platform/publish/intro-portals.md.txt#integrated-portal) | Simple self-service portal development. | Yes | Apigee 24/7 support |
| [Drupal 10 modules](https://docs.cloud.google.com/apigee/docs/api-platform/publish/intro-portals.md.txt#drupal) | Fully customizable option, based on a powerful, open source CMS integrated with Apigee using modules. | No | Apigee 24/7 support for [break-fix issues](https://docs.cloud.google.com/apigee/docs/api-platform/publish/drupal/support-for-apigee-d8-modules) |
| [Do-it-yourself (DIY)](https://docs.cloud.google.com/apigee/docs/api-platform/publish/intro-portals.md.txt#custom-portal) | Fully customizable portal development using Apigee APIs. | No | Apigee 24/7 support for Apigee APIs only |

## Choose your developer portal solution

To help you decide which developer portal solution to choose, consider the following decision
tree and review the [Comparison of developer portal features](https://docs.cloud.google.com/apigee/docs/api-platform/publish/intro-portals.md.txt#feature-comparison).
![Flow diagram showing selections for Drupal or Apigee integrated portal](https://docs.cloud.google.com/static/apigee/docs/hybrid/v1.2/images/portal-decision-tree-hybrid.png)


Consider building an [Apigee integrated portal](https://docs.cloud.google.com/apigee/docs/api-platform/publish/intro-portals.md.txt#integrated-portal) if you plan to
support common use cases for portal development, such as standard registration
and app creation flows, and more stylistic than functional changes.

## Comparison of developer portal features

The following table provides a comparison of features between the Apigee
[integrated portal](https://docs.cloud.google.com/apigee/docs/api-platform/publish/intro-portals.md.txt#integrated-portal) and the [Drupal-based developer portal](https://docs.cloud.google.com/apigee/docs/api-platform/publish/intro-portals.md.txt#drupal).

> [!NOTE]
> **Note:** When building a [custom developer portal using Apigee APIs](https://docs.cloud.google.com/apigee/docs/api-platform/publish/intro-portals.md.txt#custom-portal), all features are do-it-yourself.

| Feature | Integrated portal | Drupal |
|---|---|---|
| Portal content development using Markdown | Yes | Yes |
| Portal content development using HTML | Yes | Yes |
| API reference doc rendered from OpenAPI specifications | Yes | Yes |
| OpenAPI Specification version 3 support | Yes | Yes |
| Send live requests from your API reference | Yes | Yes |
| FedRAMP compliant |   | As a fully customizable, open-source CMS solution, it is possible to implement a Drupal portal that is FedRamp compliant. |
| Custom theme | Yes | Yes |
| Custom menus | Yes | Yes |
| Third-party tags, like Google Analytics | Yes | Yes |
| Custom JavaScript code | Yes | Yes |
| Custom domain name | Yes | Yes |
| HTTPs enabled | Yes | Yes |
| Terms and conditions for account creation | Yes | Yes |
| Mobile device display optimization | Yes | Yes |
| Integration with custom scripts and script tags | Yes |
| SMTP configuration | Yes | Yes |
| Email template configuration | Yes | Yes |
| CAPTCHA to prevent spam | Yes | Yes |
| Roles and permissions for developer/consumer accounts | Yes | Yes |
| Federated login | Yes | Yes |
| Content management APIs |   | Using Drupal |
| Monetization |   | Yes |
| Search configuration | \* | Yes |
| Blog and forums | \*\* | Yes |
| Page templates for content creation |   | Yes |
| App analytics on the portal |   | Yes |
| Rules-based event management |   | Yes |
| Extensible with add-on modules |   | Yes |
| Custom app registration flows |   | Yes |
| Custom developer registration flows |   | Yes |
| Portal logs |   | Yes |
| Link checker |   | Yes |
| Microsoft Internet Explorer/Microsoft Edge support | Microsoft Edge only | Yes |
| Regional hosting | us-west1 only | Yes (As a custom solution, you can host a Drupal portal in the region or regions of your choice.) |

> [!NOTE]
> **Footnotes:**
>
> **\*** At this time, the portal does provide a search solution out of the box; however, you can add a
> [Google custom search engine](https://docs.cloud.google.com/apigee/docs/api-platform/publish/portal/search-page.md.txt) to your portal.
>
> **\*\*** At this time, the portal isn't set up to include forums or blogs out-of-the-box;
> however, you can use services like Google Blogger, Google Groups, StackOverflow, or Medium, which
> have the advantage of being familiar to and already in use by many end users. (These services can be added using menus.)

## Build an integrated portal

Create a lightweight developer portal quickly in the Apigee UI.

Go to the **Distribution \> Portals** page in the Apigee in Cloud console:

[Go to Portals](https://console.cloud.google.com/apigee/portals)

For complete details, see
[Build your integrated portal](https://docs.cloud.google.com/apigee/docs/api-platform/publish/portal/build-integrated-portal.md.txt).

The following figure shows the landing page for the integrated portal.

![Portal intro](https://docs.cloud.google.com/static/apigee/docs/api-platform/images/sample-portal.png)

## Build a Drupal-based portal

Using the Drupal portal development tools, you can build a fully customizable developer portal. Drupal provides a rich set of
functionality and all the CMS capabilities of Drupal with additional Apigee-developed Drupal
modules. However, implementing a Drupal-based portal requires more time and effort.

Apigee and hybrid support Drupal 10, which provides a reliable open-source, enterprise-level content management system (CMS).
Because Drupal 10 is open-source, you can extend and contribute to the Drupal 10 portal development
framework and leverage the knowledge of the Drupal community. For more information, see
[Build your portal using Drupal 10](https://docs.cloud.google.com/apigee/docs/api-platform/publish/drupal/open-source-drupal-8).

## Build your own portal using Apigee APIs

Build your own, fully customized portal leveraging Apigee APIs summarized in the following table.
For more information, refer to the sections outlined in the following table.

|---|---|---|
| **Category** | **Apigee APIs** | **Description** |
| Analytics | [Stats](https://docs.cloud.google.com/apigee/docs/reference/apis/apigee/rest/v1/organizations.environments.stats.md.txt) | View analytics for your APIs. |
| API Keys | [Developer App Keys](https://docs.cloud.google.com/apigee/docs/reference/apis/apigee/rest/v1/organizations.developers.apps.keys.md.txt) | Manage API keys used to authorize the usage of APIs in apps. |
| API Products | [API Products](https://docs.cloud.google.com/apigee/docs/reference/apis/apigee/rest/v1/organizations.apiproducts.md.txt) | Manage the API products that you publish to the developer portal. |
| Applications | [Apps](https://docs.cloud.google.com/apigee/docs/reference/apis/apigee/rest/v1/organizations.apps.md.txt) [Developer Apps](https://docs.cloud.google.com/apigee/docs/reference/apis/apigee/rest/v1/organizations.developers.apps.md.txt) | Manage the applications registered by developers to consume your APIs. |
| Developers | [Developers](https://docs.cloud.google.com/apigee/docs/reference/apis/apigee/rest/v1/organizations.developers.md.txt) | Manage the developers that have registered on your developer portal. |

Simplify the integration of your portal client using the **Apigee Client Library for PHP**.
The SDK makes it easy to write PHP modules that use the Apigee APIs described in the previous table.
For more information about the Apigee API Client Library for PHP, see:

- [Overview](https://github.com/apigee/apigee-client-php#apigee-edge-client-library-for-php)
- [Installing the client library](https://github.com/apigee/apigee-client-php#installing-the-client-library)
- [Usage examples](https://github.com/apigee/apigee-client-php#usage-examples)
- [Unit tests](https://github.com/apigee/apigee-client-php#unit-tests)
- [Support](https://github.com/apigee/apigee-client-php#support)