Split cloud API reference (#929)

Author: kbatuigas

modules/ROOT/attachments/cloud-api.yaml modules/ROOT/attachments/cloud-controlplane-api.yaml

@@ -3,4 +3,6 @@
 *** xref:api:ROOT:pandaproxy-rest.adoc[]
 *** xref:api:ROOT:pandaproxy-schema-registry.adoc[]
 *** xref:api:ROOT:admin-api.adoc[]
-*** xref:api:ROOT:cloud-api.adoc[]
+*** xref:api:ROOT:cloud-api.adoc[]
+**** xref:api:ROOT:cloud-controlplane-api.adoc[]
+**** xref:api:ROOT:cloud-dataplane-api.adoc[]

modules/ROOT/attachments/cloud-dataplane-api.yaml

@@ -1,4 +1,2 @@
 = Cloud API
-:page-api-spec-url: api:ROOT:attachment$cloud-api.yaml
-:page-layout: swagger
-:page-try-it: true
+:page-layout: index

modules/ROOT/nav.adoc

@@ -0,0 +1,4 @@
+= Control Plane API
+:page-api-spec-url: api:ROOT:attachment$cloud-controlplane-api.yaml
+:page-layout: swagger
+:page-try-it: true

modules/ROOT/pages/cloud-api.adoc

@@ -1,7 +1,6 @@
 :page-layout: api-partial
 
-. To <<try-the-cloud-api,issue requests to the Cloud API from this page>>, click *Get Token*.
+. To issue requests to the Control Plane API from this page, click *Get Token*.
 . If successful, the text “1 API key applied” displays under the *Authentication* header. The token is valid for one hour.
-. Make sure to choose the correct <<servers,API server>> before making requests.
 
 See xref:redpanda-cloud:manage:api/cloud-api-authentication.adoc[Cloud API Authentication] for more information.

modules/ROOT/pages/cloud-controlplane-api.adoc

@@ -0,0 +1,30 @@
+:page-layout: api-partial
+
+The Redpanda Cloud Control Plane API enables you to programmatically manage your clusters, networks, and resource groups. 
+
+To familiarize yourself with Redpanda Cloud API basics, see the xref:redpanda-cloud:manage:api/cloud-api-overview.adoc[Redpanda Cloud API Overview]. To get started using the API, try the xref:redpanda-cloud:manage:api/cloud-api-quickstart.adoc[Quickstart].
+
+NOTE: To see the available endpoints for managing resources within your clusters, such as topics, users, access control lists (ACLs), and connectors, see the link:https://docs.redpanda.com/api/cloud-dataplane-api.html[Data Plane API Reference].
+
+== Requirements
+
+To use the Control Plane API:
+
+* You must be a customer with an existing organization in Redpanda Cloud.
+* You can only use one organization for authentication. See xref:redpanda-cloud:manage:api/cloud-api-authentication.adoc[Cloud API Authentication] for steps to authenticate API requests.
+
+== Control Plane API URL
+
+The xref:redpanda-cloud:manage:api/cloud-api-overview.adoc#control-plane-api-url[*base URL*] of the Control Plane API for all organizations is:
+
+```
+https://api.redpanda.com
+```
+
+== See also
+
+* xref:redpanda-cloud:manage:api/cloud-api-quickstart.adoc[Cloud API Quickstart]
+* xref:redpanda-cloud:manage:api/cloud-api-errors.adoc[Cloud API Error and Status Codes]
+* link:https://docs.redpanda.com/api/cloud-dataplane-api.html[Data Plane API Reference]
+
+

modules/ROOT/pages/cloud-api/oauth-receiver.adoc modules/ROOT/pages/cloud-controlplane-api/oauth-receiver.adoc

@@ -0,0 +1,4 @@
+= Data Plane APIs
+:page-api-spec-url: api:ROOT:attachment$cloud-dataplane-api.yaml
+:page-layout: swagger
+:page-try-it: true

modules/ROOT/pages/cloud/auth/auth.adoc modules/ROOT/pages/cloud-controlplane/auth/auth.adoc

@@ -0,0 +1,2 @@
+= OAuth Receiver
+:page-layout: oauth

modules/ROOT/pages/cloud-controlplane/overview/overview.adoc

@@ -0,0 +1,7 @@
+:page-layout: api-partial
+
+. To issue requests to the Data Plane APIs from this page, click *Get Token*.
+. If successful, the text “1 API key applied” displays under the *Authentication* header. The token is valid for one hour.
+. Make sure you have set the correct <<servers,API server>> value based on your <<data-plane-api-url,Data Plane API URL>>.
+
+See xref:redpanda-cloud:manage:api/cloud-api-authentication.adoc[Cloud API Authentication] for more information.

modules/ROOT/pages/cloud-dataplane-api.adoc

@@ -0,0 +1,25 @@
+:page-layout: api-partial
+
+The Redpanda Cloud Data Plane APIs enable you to programmatically manage the resources within your clusters, including topics, users, access control lists (ACLs), and connectors. 
+
+To familiarize yourself with Redpanda Cloud API basics, see the xref:redpanda-cloud:manage:api/cloud-api-overview.adoc[Redpanda Cloud API Overview]. For a quick guide to the Data Plane APIs, see xref:redpanda-cloud:manage:api/cloud-dataplane-api.adoc[Quickstart].
+
+NOTE: Redpanda Cloud uses a control plane and data plane architecture. To see the available endpoints for managing your clusters, networks, and resource groups, see the link:https://docs.redpanda.com/api/cloud-controlplane-api.html[Control Plane API Reference].
+
+== Requirements
+
+To use the Data Plane APIs:
+
+* You must be a customer with an existing organization in Redpanda Cloud.
+* You can only use one organization for authentication. See xref:redpanda-cloud:manage:api/cloud-api-authentication.adoc[Cloud API Authentication] for steps to authenticate API requests.
+
+== Data Plane API URL
+
+The xref:redpanda-cloud:manage:api/cloud-api-overview.adoc#data-plane-apis-url[*base URL*] of the Data Plane APIs is unique to every cluster. You can retrieve this value by making a link:https://docs.redpanda.com/api/cloud-controlplane-api.html#get-/v1beta2/clusters/-id-[Get Cluster] request to your target cluster. Use the `dataplane_api.url` from the response body as the base URL when calling the Data Plane API endpoints. 
+
+== See also
+
+* xref:redpanda-cloud:manage:api/cloud-api-quickstart.adoc[Cloud API Quickstart]
+* xref:redpanda-cloud:manage:api/cloud-api-errors.adoc[Cloud API Error and Status Codes]
+* link:https://docs.redpanda.com/api/cloud-controlplane-api.html[Control Plane API Reference]
+