Prompt
I'm building a developer portal for external API consumers, what should I use?
Latest observation
For an external API consumer portal, the right choice usually depends on whether you want a docs site, a self-service developer portal, or a full API management platform.
Best options by need
1) If you want the fastest path to a polished developer portal
Use a dedicated API developer portal platform:
- SwaggerHub / Stoplight / ReadMe / Redocly
- Good for:
- interactive API docs
- API key onboarding
- changelogs and versioning
- guides/tutorials
- analytics and feedback
Best pick if you want “pretty, professional, low-maintenance”:
- ReadMe for great UX and docs
- Stoplight for design-first API workflows
- Redocly for strong OpenAPI-driven documentation
2) If you need enterprise API management + portal + auth + throttling
Use an API management platform:
- Apigee
- Kong
- Azure API Management
- AWS API Gateway + custom portal
- MuleSoft, Tyk, WSO2
Good for:
- developer registration
- API keys/OAuth clients
- quotas/rate limits
- subscription plans
- approvals
- analytics
- monetization
Best pick if you need governance and access control:
- Apigee or Azure API Management for enterprise
- Kong or Tyk for more flexible/self-hosted setups
- AWS API Gateway if you’re already deep in AWS, but portal is more DIY
3) If you want something custom but modern
Build it with:
- Next.js / React
- OpenAPI spec as source of truth
- Redoc / Swagger UI for docs rendering
- Auth via OAuth2 / SSO
- Backend for API key issuance, usage dashboard, support, announcements
This is best when:
- your portal needs custom workflows
- you have product-specific onboarding
- you want full brand control
- you’re okay maintaining it
My practical recommendation
Choose based on your maturity:
- MVP / small team: ReadMe or Redocly
- Design-first API program: Stoplight
- Enterprise external API program: Apigee or Azure API Management
- Cloud-native, DIY portal: AWS API Gateway + custom Next.js portal
- Self-hosted flexible stack: Kong or Tyk + custom portal
If you want the simplest “good” answer
If your goal is an external developer portal with docs, onboarding, and a nice UX, start with:
ReadMe if you want the best out-of-the-box portal experience
Redocly if your docs are OpenAPI-centric and you want strong control
Apigee/Azure API Management if you need governance, quotas, and enterprise controls
If you tell me:
- your cloud provider,
- whether you need API keys/OAuth/onboarding,
- whether this is public or partner-only,
…I can recommend a specific stack.