- Example Dev Portal = The set of pages, partials, and specs that are provided in the example Dev Portal files.
Types of Humans
- Developer = A human who wants to learn about your APIs by visiting your Dev Portal.
- Admin = A human who has access to administer IAM functionality.
- Sometimes we clarify this to also refer to the specific permissions of the admin:
- API Gateway Admin = A human who can administer the IAM API Gateway, but not the Dev Portal or Developers.
- Dev Portal Admin = A human who can administer Dev Portal content, but not the Developers.
- Developer Admin = A human who can administer Developers, their permissions, and their credentials.
- User = A human who uses an Application.
- When OpenID Connect is in use, the User is typically involved in delegating permission to IAM API Gateway to proxy the requests that are coming from the Application that the User is using.
Types of Files
- Specifications / Specs = An API specification, in OpenAPI (formerly known as Swagger) format.
- Partials = These are Handlebar files made up of HTML, JS, and CSS content that define the look, feel, functionality, and structure of your Dev Portal.
- Pages = Pages are Handlebars templates that bring together the previously described Partial files and result in pages in your Dev Portal.
- The Loader requests Pages, Partials and Specifications from IAM, which it uses to render your Dev Portal in the visitor's browser.
- The Loader is not modifiable by Admins—instead, customization is performed by modifying Specifications, Partials, and Pages.
- API = The APIs that are proxied by IAM API Gateway, the APIs that are documented in Dev Portal, and APIs whose usage is monitored by Vitals, etc.
- Note that this is not the Admin API of IAM—we consistently refer to that as Admin API
- Consumer = An IAM concept and entity.
- Application = A computer program that calls API(s) proxied by IAM API Gateway.
- This could be a mobile or web front end, an application running on the server of a partner or customer, or an application running within your company.
Next: Getting Started