Introduction
An API product is a collection of API resources that are presented to developers as a bundle. To monetize API products, you need to bundle them into an API package.
An API package is a collection of API products that is presented to developers as a bundle, and typically associated with one or more rate plans for monetization.
Creating an API product
You need to have one or more API products to create an API package. To create an API product, see:
- Using the UI: Create API products
- Using the API: Create API Product
Viewing API products
To view the API products created for an organization:
- Using the UI, select Publish > Products
- Using the API, see the following sections:
- View API products (monetized)
By default, only monetized API products are displayed (that is, API products with at least one published rate plan). To display all API products, set the
monetized
query parameter tofalse
. This is equivalent to issuing a GET request to the non-monetized List API products API:https://api.enterprise.apigee.com/v1/organizations/{org_name}/apiproducts?expand=true
- View API products (non-monetized)
- View eligible API products for a developer
- View eligible API products for a company
The following provides an example of how to list API using the monetization API:
curl -X GET "https://ext.apiexchange.org/v1/mint/organizations/{org_name}/products?monetized=true" \ -H "Accept:application/json" \ -u email:password
The response should look something like this (only part of the response is shown):
{ "product" : [ { "customAtt1Name" : "user", "customAtt2Name" : "response size", "customAtt3Name" : "content-length", "description" : "payment api product", "displayName" : "payment", "id" : "payment", "name" : "payment", "organization" : { ... }, "pricePoints" : [ ], "status" : "CREATED", "transactionSuccessCriteria" : "status == 'SUCCESS'" }, { "customAtt1Name" : "user", "customAtt2Name" : "response size", "customAtt3Name" : "content-length", "description" : "messaging api product", "displayName" : "messaging", "id" : "messaging", "name" : "messaging", "organization" : ... }, "pricePoints" : [ ], "status" : "CREATED", "transactionSuccessCriteria" : "status == 'SUCCESS'" } ], "totalRecords" : 2 }
Monetizing API products
You monetize your API products as follows:
- Create API packages, in which each package includes one or more API products.
- Create a transaction recording policy for each API product that you want to monetize. You can also do this for each API product before you create API packages.
- Create rate plans for each API package.
These steps entail various substeps, some of which are optional. For example, when you create an API package you must include one or more API products in the package. Optionally, you can specify minimum and maximum price points for an API product associated with a revenue share rate plan (price points set restrictions on the amounts that can be charged by developers to access resources in the API product). Developers see the minimum and maximum price points when they view the details for the API package in which the product belongs.
After you complete these steps, you can publish the packages and rate plans for viewing by developers.
Get help
For help, see Apigee Customer Support.
Next steps
If you've decided which of your API products you want to monetize, start putting those products into API packages. Learn how in Create API packages.
- View API products (monetized)