Developer apps API

download spec authorize

DeveloperApp

Developer app details.

Schema

DeveloperApp
appFamily

string

Output only. App family.

apiProducts

array

List of API products to which the app is associated (when creating or updating an app). The name of the API product is the name returned when you list API products. For example, if the Display Name of the API product in the Edge UI is Premium API Product, then the name is premium-api-product (all lowercase with spaces replaced by hyphens). You can add API products later when you update the developer app. Existing API products are listed in the credentials array.

appId

string

Output only. ID of the app.

attributes

array

List of attributes used for customizing profile information or for app-specific processing. With Apigee Edge for Public Cloud, the custom attribute limit is 18. Note the folowing:

  • DisplayName is an attribute that provides the app name in the Edge UI. This can be different from the name (unique ID) of the app.
  • Notes attribute lets you add notes about the developer app.
  • Any other arbitrary name/value pairs you create are included as custom attributes.
Attribute

Developer app attribute name and value.

name

string

Name of attribute.

value

string

Value of attribute.

callbackUrl

string

Callback URL used by OAuth 2.0 authorization servers to communicate authorization codes back to apps. See the OAuth 2.0 documentation for more details.

createdAt

integer (int32)

Output only. Time the app was created in milliseconds since epoch.

createdBy

string

Output only. Email address of the developer that created the app.

credentials

array

Output only. Set of credentials for the app. Credentials are API key/secret pairs associated with API products.

object
apiProducts

array

Name and status of API products associated with the app.

APIProductRef

API product information.

attributes

array

List of attributes.

Attribute

Developer app attribute name and value.

consumerKey

string

Consumer API key.

consumerSecret

string

Consumer secret.

expiresAt

integer (int32)

Time the credentials expire in milliseconds since epoch.

issuedAt

integer (int32)

Time the credentials were issued in milliseconds since epoch.

scopes

array

OAuth scopes.

status

string

Status of the credentials.

developerId

string

Output only. ID of the developer.

keyExpiresIn

integer (int32)

Lifetime of the consumer key that will be generated for the developer app, in milliseconds. The default value, -1, indicates an infinite validity period. Once set, the expiration can't be updated.

lastModifiedAt

integer (int32)

Output only. Last modified time as milliseconds since epoch.

lastModifiedBy

string

Output only. Email of developer that last modified the app.

name (required)

string

Name of the developer app. Required when creating a developer app; not required when updating a developer app.

The name is used to uniquely identify the app for this organization and developer. Names must begin with an alphanumeric character and can contain letters, numbers, spaces, and the following characters: . _ # - $ %. While you can use spaces in the name, we recommend that you use camel case, underscores, or hyphens instead. Otherwise, you will have to URL-encode the app name when you need to include it in the URL of other Edge API calls. See the naming restrictions.

scopes

array

Scopes to apply to the app. The specified scope names must already exist on the API product that you associate with the app.

status

string

Status of the credential.