Skip to content

Add API Management documents to WSO2 Cloud - Integration Platform#570

Merged
pcnfernando merged 1 commit into
wso2:mainfrom
itsvishwa:docs/add-apim-docs
Jul 2, 2026
Merged

Add API Management documents to WSO2 Cloud - Integration Platform#570
pcnfernando merged 1 commit into
wso2:mainfrom
itsvishwa:docs/add-apim-docs

Conversation

@itsvishwa

Copy link
Copy Markdown
Contributor

Purpose

Adding the API Management documentation into the WSO2 Cloud - Integration Platform doc space under manage/cloud/api-management

Resolves https://github.com/wso2-enterprise/integration-engineering/issues/1827

@coderabbitai

coderabbitai Bot commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: b9f98291-1a99-4737-8c51-bc5089c94978

📥 Commits

Reviewing files that changed from the base of the PR and between 23d0b9c and c3d043e.

⛔ Files ignored due to path filters (13)
  • en/static/img/manage/cloud/api-management/api-key-consumption-generate-key.gif is excluded by !**/*.gif
  • en/static/img/manage/cloud/api-management/api-security-api-key-oauth2.png is excluded by !**/*.png
  • en/static/img/manage/cloud/api-management/api-security-api-key.png is excluded by !**/*.png
  • en/static/img/manage/cloud/api-management/api-security-apply.gif is excluded by !**/*.gif
  • en/static/img/manage/cloud/api-management/api-security-oauth2.gif is excluded by !**/*.gif
  • en/static/img/manage/cloud/api-management/api-security-open.png is excluded by !**/*.png
  • en/static/img/manage/cloud/api-management/lifecycle-management-open.png is excluded by !**/*.png
  • en/static/img/manage/cloud/api-management/lifecycle-management-status.png is excluded by !**/*.png
  • en/static/img/manage/cloud/api-management/lifecycle-management.png is excluded by !**/*.png
  • en/static/img/manage/cloud/api-management/oauth2-consumption-generate-token.gif is excluded by !**/*.gif
  • en/static/img/manage/cloud/api-management/open-developer-portal.gif is excluded by !**/*.gif
  • en/static/img/manage/cloud/api-management/rate-limiting.gif is excluded by !**/*.gif
  • en/static/img/manage/cloud/api-management/subscribe-api-to-application.gif is excluded by !**/*.gif
📒 Files selected for processing (7)
  • en/docs/manage/cloud/api-management/api-rate-limiting.md
  • en/docs/manage/cloud/api-management/api-security.md
  • en/docs/manage/cloud/api-management/consuming-apis/consuming-an-api-secured-with-an-api-key.md
  • en/docs/manage/cloud/api-management/consuming-apis/consuming-an-api-secured-with-oauth2.md
  • en/docs/manage/cloud/api-management/lifecycle-management.md
  • en/docs/manage/cloud/api-management/overview.md
  • en/sidebars.ts
👮 Files not reviewed due to content moderation or server errors (7)
  • en/docs/manage/cloud/api-management/consuming-apis/consuming-an-api-secured-with-an-api-key.md
  • en/docs/manage/cloud/api-management/lifecycle-management.md
  • en/docs/manage/cloud/api-management/consuming-apis/consuming-an-api-secured-with-oauth2.md
  • en/docs/manage/cloud/api-management/api-security.md
  • en/docs/manage/cloud/api-management/api-rate-limiting.md
  • en/sidebars.ts
  • en/docs/manage/cloud/api-management/overview.md

📝 Walkthrough

[!WARNING]

Walkthrough skipped

File diffs could not be summarized.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@github-actions

github-actions Bot commented Jul 2, 2026

Copy link
Copy Markdown

Broken links, images & orphan pages

Passing — no broken links or images found.

Links/images come from one crawl of the production build (baseUrl-aware). Orphans are docs not referenced by sidebars.ts.

Summary

  • Broken links & images — total 0 · 🆕 introduced 0 · 📄 already on main 0
  • Orphan pages — total 8 · 🆕 introduced 0 · 📄 already on main 8

Broken links & images

Introduced by this PR

No new broken link(s)/image(s) introduced by this PR. ✅

Already on main — 0 total

None.

Orphan pages

Introduced by this PR

No new orphan page(s) introduced by this PR. ✅

Already on main — 8 total

Already present on the base branch (not caused by this PR):

Show 8
  • docs/deploy-operate/observe/datadog-integration
  • docs/deploy-operate/observe/elastic-stack-elk
  • docs/deploy-operate/observe/metrics-prometheus-grafana
  • docs/deploy-operate/observe/opensearch-integration
  • docs/deploy-operate/observe/recipe-elk-stack
  • docs/deploy-operate/observe/recipe-kubernetes-production
  • docs/deploy-operate/observe/recipe-local-development
  • docs/deploy-operate/observe/recipe-opensearch-setup

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new API Management documentation section to the WSO2 Cloud – Integration Platform docs, and wires it into the Docusaurus sidebar under manage/cloud/api-management.

Changes:

  • Adds an API Management category to en/sidebars.ts with an overview page, feature pages, and a “Consuming APIs” subsection.
  • Introduces new API management docs covering overview, lifecycle management, security schemes, rate limiting, and API consumption guides (API Key and OAuth2).

Reviewed changes

Copilot reviewed 7 out of 20 changed files in this pull request and generated 8 comments.

Show a summary per file
File Description
en/sidebars.ts Adds the “API Management” sidebar category and links to the new docs.
en/docs/manage/cloud/api-management/overview.md New landing page describing API management capabilities and linking to subtopics.
en/docs/manage/cloud/api-management/lifecycle-management.md New guide describing lifecycle states and how to transition them in the console.
en/docs/manage/cloud/api-management/api-security.md New guide describing API Key/OAuth2 security schemes and configuration steps.
en/docs/manage/cloud/api-management/api-rate-limiting.md New guide describing rate limiting setup and response headers.
en/docs/manage/cloud/api-management/consuming-apis/consuming-an-api-secured-with-an-api-key.md New step-by-step guide for consuming API Key secured APIs via the Developer Portal.
en/docs/manage/cloud/api-management/consuming-apis/consuming-an-api-secured-with-oauth2.md New step-by-step guide for consuming OAuth2 secured APIs via the Developer Portal.

Comment on lines +23 to +25
4. In the integration **Overview** page, on the right side, click the **Developer Portal** icon. This will open the Developer Portal for the selected API.
![Open Developer Portal](/img/manage/cloud/api-management/open-developer-portal.gif)
5. In the Developer Portal, click **Subscribe** to subscribe the API to an application.
Comment on lines +27 to +29
7. Once the application is created, click **Subscribe** to complete the subscription process.
![Subscribe API to Application](/img/manage/cloud/api-management/subscribe-api-to-application.gif)
8. In the left navigation menu, click **Applications** and select your application.
Comment on lines +32 to +34
11. Enter a name for the API Key in the **API Key Name** field and click **Generate** to generate the API Key.
![Generate API Key](/img/manage/cloud/api-management/api-key-consumption-generate-key.gif)

Comment on lines +23 to +25
4. In the integration **Overview** page, on the right side, click the **Developer Portal** icon. This will open the Developer Portal for the selected API.
![Open Developer Portal](/img/manage/cloud/api-management/open-developer-portal.gif)
5. In the Developer Portal, click **Subscribe** to subscribe the API to an application.
Comment on lines +27 to +29
7. Once the application is created, click **Subscribe** to complete the subscription process.
![Subscribe API to Application](/img/manage/cloud/api-management/subscribe-api-to-application.gif)
8. In the left navigation menu, click **Applications** and select your application.
Comment on lines +33 to +35
12. To test the API, click **Generate** under the **Token** subsection. This will generate an access token using the OAuth2 client credentials flow.
![Generate OAuth2 Token](/img/manage/cloud/api-management/oauth2-consumption-generate-token.gif)

Comment on lines +30 to +32
4. In the integration **Overview** page, on the right side, click **Configure Security**.
![Open API Security](/img/manage/cloud/api-management/api-security-open.png)
5. In the **Configure Security** pane, select the **Security Scheme** you want to use (API Key or OAuth2).
Comment on lines +34 to +37
- With the **API Key** scheme, you can select Resource Level security for the API. By default, security is applied at the API level.
![API Security - API Key](/img/manage/cloud/api-management/api-security-api-key.png)
- With the **OAuth2** scheme, in addition to Resource Level security configurations, you can also configure permissions for the API. You can select from the available scopes or create new ones, and then assign them to each resource.
![API Security - OAuth2](/img/manage/cloud/api-management/api-security-oauth2.gif)
@pcnfernando pcnfernando merged commit d7e047f into wso2:main Jul 2, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants