# wso2/product-apim architecture

> Architecture diagram of the GitHub repository wso2/product-apim, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/wso2/product-apim
- Repository: https://github.com/wso2/product-apim

## Overview

WSO2 API Manager is a platform for designing and publishing managed APIs, letting consumers discover them, and exposing services through a managed runtime. The README establishes the Publisher-to-Developer-Portal product workflow and highlights protocol support, integration, and extensibility. The supplied tree contains portal extensions and recommendation-engine code, but little of the main runtime; integration fixtures and test infrastructure are therefore omitted. Links among the documented product stages reflect README statements, not inspected runtime call paths.

Main entry points: [`api-control-plane/modules/distribution/product/src/main/api-publisher-extension`](https://github.com/wso2/product-apim/tree/master/api-control-plane/modules/distribution/product/src/main/api-publisher-extension) (API Publisher), [`gateway/modules`](https://github.com/wso2/product-apim/tree/master/gateway/modules) (API gateway), [`all-in-one-apim/modules`](https://github.com/wso2/product-apim/tree/master/all-in-one-apim/modules) (Integration runtime), [`api-control-plane/modules/distribution/product/src/main/api-store-extension`](https://github.com/wso2/product-apim/tree/master/api-control-plane/modules/distribution/product/src/main/api-store-extension) (Developer Portal)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api_lifecycle["API lifecycle"]
  node_publisher["API Publisher"]
  node_api_design["API design"]
  node_api_products["API products"]
  node_api_management["API lifecycle management"]
  node_portal["Developer Portal"]
end

subgraph group_runtime["API runtime"]
  node_gateway["API gateway"]
  node_protocols["API protocols"]
  node_integration["Integration runtime"]
  node_mediation["Mediation and routing"]
  node_streaming["Streaming data"]
end

subgraph group_extensions["Extensions"]
  node_customization["Platform extensions"]
  node_recommendation["API recommendations"]
end

node_developer(("API developer"))
node_consumer(("API consumer"))
node_service["Digital services"]

node_developer -->|"designs APIs"| node_publisher
node_publisher -->|"designs"| node_api_design
node_publisher -->|"creates products"| node_api_products
node_publisher -->|"manages lifecycle"| node_api_management
node_consumer -->|"discovers APIs"| node_portal
node_portal -.->|"accesses APIs"| node_gateway
node_service -->|"exposes APIs"| node_gateway
node_gateway -->|"supports"| node_protocols
node_integration -->|"provides"| node_mediation
node_integration -->|"processes"| node_streaming
node_publisher -->|"supports extensions"| node_customization

click node_publisher "https://github.com/wso2/product-apim/tree/master/api-control-plane/modules/distribution/product/src/main/api-publisher-extension"
click node_api_design "https://github.com/wso2/product-apim/tree/master/api-control-plane/modules"
click node_api_products "https://github.com/wso2/product-apim/tree/master/api-control-plane/modules"
click node_api_management "https://github.com/wso2/product-apim/tree/master/api-control-plane/modules"
click node_portal "https://github.com/wso2/product-apim/tree/master/api-control-plane/modules/distribution/product/src/main/api-store-extension"
click node_gateway "https://github.com/wso2/product-apim/tree/master/gateway/modules"
click node_protocols "https://github.com/wso2/product-apim/tree/master/gateway/modules"
click node_integration "https://github.com/wso2/product-apim/tree/master/all-in-one-apim/modules"
click node_mediation "https://github.com/wso2/product-apim/tree/master/all-in-one-apim/modules"
click node_streaming "https://github.com/wso2/product-apim/tree/master/all-in-one-apim/modules"
click node_customization "https://github.com/wso2/product-apim/tree/master/api-control-plane/modules/distribution/product/src/main"
click node_recommendation "https://github.com/wso2/product-apim/tree/master/gateway/modules/recommendation-engine/repository/components"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_publisher,node_api_design,node_api_products,node_api_management,node_portal toneBlue
class node_gateway,node_protocols,node_integration,node_mediation,node_streaming toneAmber
class node_customization,node_recommendation,node_developer,node_consumer toneMint
class node_service toneIndigo
```

## Components

### API lifecycle

- [API Publisher](https://github.com/wso2/product-apim/tree/master/api-control-plane/modules/distribution/product/src/main/api-publisher-extension): `api-control-plane/modules/distribution/product/src/main/api-publisher-extension`
- [API design](https://github.com/wso2/product-apim/tree/master/api-control-plane/modules): `api-control-plane/modules`
- [API products](https://github.com/wso2/product-apim/tree/master/api-control-plane/modules): `api-control-plane/modules`
- [API lifecycle management](https://github.com/wso2/product-apim/tree/master/api-control-plane/modules): `api-control-plane/modules`
- [Developer Portal](https://github.com/wso2/product-apim/tree/master/api-control-plane/modules/distribution/product/src/main/api-store-extension): `api-control-plane/modules/distribution/product/src/main/api-store-extension`

### API runtime

- [API gateway](https://github.com/wso2/product-apim/tree/master/gateway/modules): `gateway/modules`
- [API protocols](https://github.com/wso2/product-apim/tree/master/gateway/modules): `gateway/modules`
- [Integration runtime](https://github.com/wso2/product-apim/tree/master/all-in-one-apim/modules): `all-in-one-apim/modules`
- [Mediation and routing](https://github.com/wso2/product-apim/tree/master/all-in-one-apim/modules): `all-in-one-apim/modules`
- [Streaming data](https://github.com/wso2/product-apim/tree/master/all-in-one-apim/modules): `all-in-one-apim/modules`

### Extensions

- [Platform extensions](https://github.com/wso2/product-apim/tree/master/api-control-plane/modules/distribution/product/src/main): `api-control-plane/modules/distribution/product/src/main`
- [API recommendations](https://github.com/wso2/product-apim/tree/master/gateway/modules/recommendation-engine/repository/components): `gateway/modules/recommendation-engine/repository/components`

### Other components

- **API developer**
- **API consumer**
- **Digital services**

## Connections

- API developer → API Publisher: designs APIs (evidence: `README.md`)
- API Publisher → API design: designs (evidence: `README.md`)
- API Publisher → API products: creates products (evidence: `README.md`)
- API Publisher → API lifecycle management: manages lifecycle (evidence: `README.md`)
- API consumer → Developer Portal: discovers APIs (evidence: `README.md`)
- Developer Portal → API gateway: accesses APIs
- Digital services → API gateway: exposes APIs (evidence: `README.md`)
- API gateway → API protocols: supports (evidence: `README.md`)
- Integration runtime → Mediation and routing: provides (evidence: `README.md`)
- Integration runtime → Streaming data: processes (evidence: `README.md`)
- API Publisher → Platform extensions: supports extensions (evidence: `README.md`)
