Developer Portal
The Developer Portal is the consumer-facing view of your API catalogue. It’s where developers discover APIs, read documentation, subscribe, and manage their credentials.
What Consumers See
Section titled “What Consumers See”The portal presents a unified catalogue of all APIs available to a consumer:
- Produced APIs — APIs your organisation publishes
- Consumed APIs — External APIs your organisation subscribes to
- Marketplace APIs — APIs from other organisations available for subscription
Each API listing shows:
| Information | Source |
|---|---|
| Name and description | OAS info section |
| Endpoints and operations | OAS paths |
| Request/response schemas | OAS components |
| Authentication requirements | OAS security |
| SLA tiers and pricing | OpenSLA definition |
| Compliance score | Compliance service |
API Documentation
Section titled “API Documentation”API documentation is generated directly from the OpenAPI specification. Apiway renders interactive docs where consumers can:
- Browse endpoints and operations
- View request/response schemas with examples
- See authentication requirements
- Understand rate limits and quotas
Subscribing
Section titled “Subscribing”Consumers subscribe to APIs to get access. The subscription flow:
- Browse the catalogue and find an API
- Select an SLA tier (if the producer defines multiple tiers)
- Submit a subscription request
- Governance review (if configured by the producer)
- Credentials provisioned automatically on approval
- Start calling the API
See Subscribing to APIs for the full flow.
Self-Service
Section titled “Self-Service”The portal is designed for self-service. Consumers don’t need to email the API team or wait for manual provisioning. The flow is:
- Subscribe → governance review → credentials → go
For internal APIs with auto-approval, this is instant. For external or production APIs, governance adds the appropriate oversight.
In This Section
Section titled “In This Section”- Subscribing to APIs — The subscription lifecycle
- API Economy — Cross-organisation API marketplace