Building an API Proxy with Apigee Edge

15 minutes
  • 8 Learning Objectives

About this Hands-on Lab

The API proxy is what Apigee is all about. It sits between any device or app making a request and the backend server or service that sends a response. Once an API proxy is created, a world of customization is available – but you have to create the proxy first. In this hands-on lab, we’ll do just that, working with a full-fledged OpenAPI specification as our base. We’ll use this proxy as a springboard for further hands-on labs, so this is an important first step.

Learning Objectives

Successfully complete this lab by achieving the following learning objectives:

Retrieve the Working Files
  1. In your terminal, clone the repo that contains the working files for this lab:
    cd ~/downloads   
    git clone
Create a New API Proxy
  1. From the Apigee dashboard, choose API Proxies.
  2. Click the + Proxy button, and select New Spec.
Select a Proxy Type
  1. On the Type screen, choose Reverse Proxy from the list of types of proxies.
  2. Click the Use OpenAPI button.
  3. In the dialog, choose Upload file.
  4. Click the CLICK TO UPLOAD FILES button.
  5. Navigate to the cloned repo. Within the repo, open the create-api-proxy folder, and choose the OpenWeatherMapAPI.yaml file.
  6. In the dialog, click Select.
  7. From the Create Proxy page, click Next.
Specify the Proxy Details
  1. On the Details screen, change the Proxy Name to LA-Weather.
  2. Change the Proxy Base Path to /v1/la-weather.
  3. Leave the remaining values set to their defaults, and click Next.
Set the Flows
  1. On the Flows screen, make sure the /weather GET flow is selected.
  2. Click Next.
Configure the Security Settings
  1. On the Security screen, select the Pass through (none) option.
  2. Leave the Add CORS header option unchecked.
  3. Click Next.
Choose the Virtual Hosts
  1. On the Virtual Hosts screen, make sure that the default and secure options are both selected.
  2. Click Next.
Build and Deploy the Proxy
  1. On the Build screen, in the Deploy Environments section, make sure that only the test option is selected.
  2. Click Build and Deploy.
  3. After the proxy is deployed, click the provided link on the Summary screen.

Additional Resources

You've been tasked with setting up an API proxy to connect to the OpenWeatherMap API so that your company's new app can display weather information along with their other services.

You’ll need to complete the following steps to accomplish your task:

  1. Choose the type of proxy.
  2. Provide details, including the proxy base path.
  3. Select security options.
  4. Set the virtual hosts.
  5. Build and deploy the API proxy.

What are Hands-on Labs

Hands-on Labs are real environments created by industry experts to help you learn. These environments help you gain knowledge and experience, practice without compromising your system, test without risk, destroy without fear, and let you learn from your mistakes. Hands-on Labs: practice your skills before delivering in the real world.

Sign In
Welcome Back!

Psst…this one if you’ve been moved to ACG!

Get Started
Who’s going to be learning?