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

Apigee is a platform for developing and managing APIs. By fronting services with a
proxy layer, Apigee provides an abstraction or facade for your backend service APIs and provides
security, rate limiting, quotas, analytics, and more.


**Video:** Check out this short video for an introduction to Apigee API Management.
[Video](https://www.youtube.com/watch?v=vGe38icp0n4)

## High-level architecture

The following image shows the high-level architecture of Apigee:

![High level overview
of the Apigee architecture.](https://docs.cloud.google.com/static/apigee/docs/api-platform/images/ng-saas/ng-saas-arch.png)

As the image shows, Apigee consists of the following primary components:

- **Apigee services:** The APIs that you use to create, manage, and deploy your API proxies.
- **Apigee runtime:** A set of containerized runtime services in a Kubernetes cluster that Google maintains. All API traffic passes through and is processed by these services.

In addition, Apigee uses other components including:

- **Google Cloud services:** Provides identity management, logging, analytics, metrics, and project management functions.
- **Back-end services:** Used by your apps to provide runtime access to data for your API proxies.

For more detailed explanations, see [Components of Apigee](https://docs.cloud.google.com/apigee/docs/api-platform/get-started/what-apigee-old.md.txt#components).

Here's a more granular image showing the connection between your Cloud project and
Google services over a private peering network:

![Architecture
diagram showing the VPC connections.](https://docs.cloud.google.com/static/apigee/docs/api-platform/images/ng-saas/arch-apigee-level2.png)

For an example of how to use Apigee, check out
[this
webcast about how Walgreens uses APIs and Apigee](https://www.youtube.com/watch?v=_Bb7UXb7ds4) to provide a rich app ecosystem
around photo printing, prescriptions, and other services.

#### Enough talk!

|---|---|---|---|
| [Set up Apigee](https://docs.cloud.google.com/apigee/docs/api-platform/get-started/overview.md.txt) | and then | [Build your first proxy!](https://docs.cloud.google.com/apigee/docs/api-platform/get-started/get-started.md.txt) |   |

## Flavors of Apigee

Apigee comes in the following flavors:

- **Apigee:** A cloud version hosted by Apigee in which Apigee maintains the environment, allowing you to concentrate on building your services and defining the APIs to those services.
- **Apigee hybrid:** A hybrid version consisting of a runtime plane installed on-premises or in a cloud provider of your choice, and a management plane running in Apigee's cloud. In this model, API traffic and data are confined within your own enterprise-approved boundaries.

## Digital acceleration

This video gives you a quick view of how Apigee helps you evolve into a digital
business.
<iframe title="Apigee: The Cross-Cloud API Platform" allowfullscreen frameborder="0" height="315" scrolling="no" src="https://www.youtube.com/embed/FPj_va9-rM8" width="560"></iframe>

## Choosing between service management and API management

This video helps you understand the important differences between service management and
API management.
<iframe title="Apigee: Choosing between service management and API management" width="560" height="315" src="https://www.youtube.com/embed/1FV0Vv-me08" scrolling="no" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

## Making your services available on the web

Companies today want to make their backend services available on the web so that these
services can be consumed by apps running on mobile devices and desktops. A company might want to
expose services that provide product pricing and availability information, sales and ordering
services, order tracking services, and any other services required by client apps.

Companies often expose services as a set of HTTP endpoints. Client app developers then make
HTTP requests to these endpoints. Depending on the endpoint, the service might then return
data, formatted as XML or JSON, back to the client app.

The client apps that consume these services can be implemented as standalone apps for a mobile
device or tablet, as HTML5 apps running in a browser, or as any other type of app that can make a
request to an HTTP endpoint and consume any response data. These apps might be developed and
released by the same company that exposed the services, or by third-party app developers who make
use of publicly available services.

The following image shows this type of model:

![Several kinds of apps such as mobile apps, point of
sale apps, partners, and web apps connect to
backend services, such as ESB, SOA, app servers,
and databases.](https://docs.cloud.google.com/static/apigee/docs/api-platform/images/noEdge.png)

Because providers make their services available over the web, they must ensure that they have
taken all necessary steps to secure and protect their services from unauthorized access. As a
service provider, consider:

- **Security:** How will you control access to your services to prevent unauthorized access?
- **Compatibility:** Will your services work across different platforms and devices?
- **Measurability:** How can you monitor your services to make sure they are available?
- And many other considerations

After a client app has been released that accesses any services, the service provider is then
required to make sure that those services continue to work over time as they add, modify, or
delete those services. The service provider must also have a way to keep app developers aware of
any changes to the services to ensure that client apps stay in sync with those services.

Client app developers face challenges when trying to consume services from different
providers. There are many technologies available today for use by a service provider to expose
its services. The same client app might have to use one mechanism to consume a service from one
provider, and a different mechanism to consume a service from a different provider. App
developers can even face the situation where they have to use different mechanisms to consume
services from the same provider.

## Make services available through Apigee

Apigee enables you to provide secure access to your services
with a well-defined API that is consistent across all of your services, regardless of service
implementation. A consistent API:

- Makes it easy for app developers to consume your services.
- Enables you to change the backend service implementation without affecting the public API.
- Enables you to take advantage of the analytics, developer portal, and other features built into Apigee.

The following image shows an architecture with Apigee handling the requests from client apps to
your backend services:

![Apigee sits between clients applications and backend services.](https://docs.cloud.google.com/static/apigee/docs/api-platform/images/ng-saas/apigee-in-the-middle.png)

Rather than having app developers consume your services directly, they access an API proxy
created on Apigee. The API proxy functions as a mapping of a publicly available HTTP endpoint to
your backend service. By creating an API proxy you let Apigee handle the security and
authorization tasks required to protect your services, as well as to analyze and monitor those
services.

Because app developers make HTTP requests to an API proxy, rather than directly to your
services, developers do not need to know anything about the implementation of your
services. All the developer needs to know is:

- The URL of the API proxy endpoint.
- Any query parameters, headers, or body parameters passed in a request.
- Any required authentication and authorization credentials.
- The format of the response, including the response data format, such as XML or JSON.

The API proxy isolates the app developer from your backend service. Therefore you are free to
change the service implementation as long as the public API remains consistent. For example, you
can change a database implementation, move your services to a new host, or make any other changes
to the service implementation. By maintaining a consistent frontend API, existing client apps
will continue to work regardless of changes on the backend.

You can use policies on the API proxy to add functionality to a service without having to make
any changes to the backend service. For example, you can add policies to your proxy to perform
data transformations and filtering, add security, execute conditional logic or custom code, and
to perform many other actions. The important thing to remember is you implement policies on Apigee,
not on your backend server.

For more information, see [Understanding APIs and API
proxies](https://docs.cloud.google.com/apigee/docs/api-platform/fundamentals/understanding-apis-and-api-proxies).

## Create an API product

An API proxy is the HTTP endpoint on Apigee that developers use to access your backend
services. While it is possible, you typically do not make individual API proxies available.
Instead, you group one or more API proxies into an API product.

An API product is a bundle of API proxies combined with a service plan. That service plan can
set access limits on API proxies, provide security, allow monitoring and analytics, and provide
additional features. API products are also the central mechanism that Apigee uses for authorization
and access control to your APIs.

You have a great deal of flexibility when creating API products. For example, multiple API
products can share the same API proxy. The following figure shows three API products. Notice that
all products allow access to API proxy 3, but only product A allows access to API proxy 1.

![Product A accesses proxy 1 and 3. Product B accesses proxy 3.
Product C accesses proxy 2, 3, and 4.](https://docs.cloud.google.com/static/apigee/docs/api-platform/images/products.png)

You can set different properties on each API product. For example, you might make available
one API product with a low access limit, such as 1000 requests per day, for a bargain price. You
then release another API product that provides access to the same API proxy, but with a much
higher access limit, for a higher price. Or, you might create a free API product that allows
read-only access to your services, and then sell an API product to the same API proxies that
allows read/write access.

For more information, see [Create API
products](https://docs.cloud.google.com/apigee/docs/api-platform/publish/create-api-products).

### Allow a client-side app to access your API product

When app developers decide that they want to access your services, they must first register
their client app with your API product.
![A client app
needs a key to call an API associated with an API Product.](https://docs.cloud.google.com/static/apigee/docs/api-platform/images/apikey.png)

Upon registration, an app developer receives an API key
that they must then include in every request to an API proxy included in the API product. That
key is authenticated and, if authentication is successful, the request is allowed to access your
backend service.

At any time, you can revoke the key so that the client app no longer has access to your
services. Or, you can define a time limit on a key so that the developer must refresh the key
after a specific time.

You decide how to handle registration requests from developers to access your API products. By
using Apigee Developer Services, you can automate the registration process; or you can use a
manual process to control access.

### Create API products and make them available to developers

1. Create one or more API proxies that map publicly available URLs to your backend services.
2. Create an API product that bundles your API proxies.
3. Deploy your API proxies and API product.
4. Let your developers know that the API product is available.

Once app developers know about the availability of your API product, they:

1. Register their client apps with your API product.
2. Receive an API key for the API product.
3. Make requests to your services through API proxies (which are bundled in the API product) and pass the API key with each request.

## Components of Apigee

Apigee consists of API runtime, monitoring and analytics, and developer services that
together provide a comprehensive infrastructure for API creation, security, management,
and operations.

The following image shows the high-level architecture of Apigee:

![Apigee high
level architecture](https://docs.cloud.google.com/static/apigee/docs/api-platform/images/ng-saas/ng-saas-arch.png)

### Apigee runtime

Apigee services are all about creating and consuming APIs, whether you're building
API proxies as a service provider or using APIs, SDKs, and other convenience services as an app
developer.

The API runtime provides tools for adding and configuring
your API proxies, setting up API products, and managing app developers and client apps. It
offloads many common management concerns from your backend services. When you add an API proxy,
you can apply policies to the API proxy for adding security, rate-limiting, mediation, caching,
and so on. You can also customize the behavior of your API proxy by applying custom scripts,
making calls out to third-party APIs and services, and so on. See
[Understanding
APIs and API proxies](https://docs.cloud.google.com/apigee/docs/api-platform/fundamentals/understanding-apis-and-api-proxies) for more.

### Apigee monitoring \& analytics

Apigee API Analytics provides powerful tools to see short- and long-term usage
trends of your APIs. You can segment your audience by top developers and apps, understand usage
by API method to know where to invest, and create custom reports on business- or
operational-level information.

As data passes through Apigee, several default types of information are collected including URL,
IP, user ID for API call information, latency, error data, and so on. You can create policies to
add other information, such as headers, query parameters, and portions of a request or response
extracted from XML or JSON. This information is collected asynchronously from the actual
request/response flow and therefore has no effect on API performance.

The Apigee UI lets you view multiple metrics and dimensions in a browser, as shown in the
following figure:

![An analytics dashboard that shows the number of policy errors in graph and
tabular form.](https://docs.cloud.google.com/static/apigee/docs/api-platform/images/new_edge_analytics.png)

However, you can also access and control the Analytics Service by a command-line interface or
through RESTful APIs. See [API Analytics overview](https://docs.cloud.google.com/apigee/docs/api-platform/analytics/analytics-services-overview.md.txt) for
more.

### Apigee developer ecosystem

Apigee provides developer services that enable you to:

- Manage the community of app developers that are using your services.
- Work with internal and external developers and formalize the relationships with financial models.
- Onboard developers and create a developer portal. App developers connect to your portal to access API documentation to learn more about your publicly available API products and manage API keys.

Every Apigee customer can create their own developer portal in the cloud.

Apigee enables you to create two types of portals:

- [Integrated
  portal](https://docs.cloud.google.com/apigee/docs/api-platform/publish/portal/build-integrated-portal) which can be instantly provisioned.

  ![The default integrated portal page with links labeled Quick start, get started, and APIs.](https://docs.cloud.google.com/static/apigee/docs/api-platform/images/sample-portal.png)
- [Drupal-based portal](https://docs.cloud.google.com/apigee/docs/api-platform/publish/drupal/open-source-drupal-8) which enables full customization.