viewing Apigee X documentation.
View Apigee Edge documentation.
In this step, you'll publish an API to the portal by performing the following steps:
Step 1: Create an API Proxy from a spec
Create an API proxy from an OpenAPI Specification that describes the API.
To create an API proxy from an OpenAPI Specification:
- In the Apigee UI, select Develop > API proxies in the left navigation bar to open the API proxies page.
Click Create New.
The Create Proxy wizard opens prompting you to select the type of API proxy to create.
Under Reverse Proxy (most common), click Use OpenAPI Spec.
The Use OpenAPI Spec dialog displays.
Copy and paste the following URL in OpenAPI Spec URL field on the URL tab:
The Create Proxy wizard opens and the Proxy details page is prepopulated using values from the OpenAPI Specification.
Edit the Description field as follows: API proxy for hello world.
On the Policies page:
- Under Security: Authorization, select Pass through (no authorization).
- Under Security: Browser, select Add CORS headers .
On the Flows page, make sure all operations are selected and click Next.
On the Summary page, select the environment to which you want to deploy under Optional Deployment.
Click Create and deploy.
On the Summary page, you'll see an acknowledgement that your new API proxy was created successfully and deployed to the selected environment.
Step 2: Create an API product
Create an API product that contains the API resources that you want to expose to your API consumers.
To create an API product:
- In the Apigee UI, select Publish > API Products in the left navigation bar to open the API Products page.
The Product page is displayed.
Enter the Product Details for your API product.
Note: The Display Name and Description fields are displayed in the portal when you publish the API product, by default. You can edit the values in Step 3: Publish the API to your portal.
Field Value Name Hello World Display Name Hello World Description Simple hello world example Environment Select environment where API proxy is deployed. Access Public Automatically approve access requests Enabled Quota (leave blank) Allowed OAuth Scopes (leave blank)
- In the Operations section, click ADD AN OPERATION to identify the operations to add to your API product.
- Under Source, click API proxy and select Mock-Target-API from the drop-down.
- Under Operation, enter a forward slash (
/) in the Path field. Ignore the other fields.
- Click Save to save the Operation.
- The Add Operation dialog displays.
- Click Add.
- Click Save.
Step 3: Publish the API to your portal
Publish the API to your portal to enable your customers to learn about and use it.
To publish the API to your portal:
- In the Apigee UI, navigate to the APIs page in your portal:
- Select Publish > Portals in the left navigation bar.
- Click in the My first portal row to open the portal.
- Click API Catalog to display the APIs page.
- Click +.
- Select Hello World in the Add an API product to the catalog dialog and click Next.
- Under API details, configure the following options:
- Select Published (listed in the catalog) to publish the API to your portal.
- For Display image:
- Click Select image.
home-background.jpgfrom the list of existing images in the Select image dialog.
- Click Select.
- Preview the image and click Select.
- For Categories, enter Get Started and press Enter.
Leave all other values set to their defaults.
- Under API documentation, to auto-generate API reference documentation from a snapshot of your OpenAPI
- Select Select an OpenAPI spec in the Source API spec drop-down.
- Select the Import from a URL tab.
- Enter helloworld in the Spec name field.
- Copy and paste the following URL in the URL field and press Enter:
- Click Select.
- Click Save.
To view the API reference documentation:
- In the Apigee UI, click Live Portal to view the changes in the live portal (or refresh the live portal if it is already open in another tab).
- In the live portal:
a. Click APIs in the top navigation bar to the view published API.
b. Click the Hello World card to view the API reference documentation.
c. Give your API a try!