[API Shield] API Gateway update (cloudflare#22757)

* API Gateway update

* ordering and links

* copy

* tiny edit

* fix headers

* Update src/content/docs/api-shield/api-gateway.mdx

Co-authored-by: ranbel <[email protected]>

---------

Co-authored-by: ranbel <[email protected]>

Author: 2 people

src/content/docs/api-shield/api-gateway.mdx

@@ -3,14 +3,50 @@ pcx_content_type: concept
 type: overview
 title: API Gateway
 sidebar:
-  order: 5
+  order: 7
 
 ---
 
-API Gateway is a package of features that will do everything for your APIs, including:
+Cloudflare API Shield empowers you to use Cloudflare as your API Gateway, providing robust security features, streamlined management tools, and integration with the Cloudflare Developer Platform for building new APIs.​
 
-- **Security**: Protect your API from malicious traffic with [API Discovery](/api-shield/security/api-discovery/), [Schema validation](/api-shield/security/schema-validation/), [mTLS validation](/api-shield/security/mtls/), and more.
-- **Management and monitoring**: Streamline API management with [Endpoint Management](/api-shield/management-and-monitoring/) and [tools](https://blog.cloudflare.com/api-gateway/) like analytics, routing, and authentication.
-- **Logging, quota management, and more**: All of Cloudflare's [established features](https://blog.cloudflare.com/api-gateway/), like caching, load balancing, and log integrations work natively with API Gateway.
+APIs are fundamental to modern applications but are increasingly targeted by malicious actors. Cloudflare API Shield offers a comprehensive solution to protect, manage, and build your APIs.
 
-For more details about API Gateway, refer to the [introductory blog post](https://blog.cloudflare.com/api-gateway/).
+- **Enhanced security**: Implement robust runtime protection such as JWT validation, mutual TLS (mTLS) authentication, schema validation, and protection against the [OWASP Top 10 API Security risks](https://owasp.org/www-project-api-security/).
+
+- **Efficient management and monitoring**: Utilize tools for endpoint management, analytics, and routing to streamline API operations. Highlight risks with Posture Management, and gain visibility with Security Analytics and Security Center Insights.
+
+- **Integrated development**: Leverage the Cloudflare Developer Platform to build and deploy new APIs with ease, taking advantage of scalable infrastructure and a suite of developer tools.
+
+## Cloudflare as your API Gateway
+
+### API security features
+
+- **Protection Against OWASP Top 10 API Security risks**: Mitigate common API vulnerabilities, including injection attacks and improper asset management.
+
+### Management and Monitoring tools
+
+- **[Endpoint Management](/api-shield/management-and-monitoring/endpoint-management/)**: Gain visibility into your API endpoints, including discovery of shadow APIs and monitoring of active endpoints.
+
+- **[Analytics and logging](/api-shield/security/sequence-analytics/)**: Access detailed analytics and logs to monitor API usage, performance, and security events.
+
+- **[API Routing](/api-shield/management-and-monitoring/api-routing/)**: Optimize API performance and reliability with secure routing.
+
+- **[Posture Management](/api-shield/security/authentication-posture/)**: Monitor API Authentication status and receive alerts for common API risks.
+
+### Build APIs with Cloudflare’s Developer Platform
+
+The [Cloudflare Developer Platform](https://www.cloudflare.com/developer-platform/) offers a serverless execution environment, allowing you to build and deploy new APIs without the need to manage infrastructure. Its benefits include:
+
+- **Global scalability**: Deploy your APIs across Cloudflare's extensive global network, ensuring low latency and high availability. ​
+
+- **Integrated services**: Access a suite of services, including storage, databases, and AI tools, to enhance your API functionality.
+
+- **Developer-friendly tools**: Utilize modern development tools and frameworks to streamline the API development process. ​
+
+## Get started
+
+To begin using Cloudflare API Shield, refer to our [Get started](/api-shield/get-started/) guide.
+
+For detailed instructions and additional resources, refer to the Cloudflare [API Shield documentation](/api-shield/).
+
+By integrating API security, management, and development into a single platform, Cloudflare API Shield provides a comprehensive solution to protect, manage, and build APIs.

src/content/docs/api-shield/management-and-monitoring/index.mdx

@@ -2,7 +2,7 @@
 pcx_content_type: reference
 title: Management and Monitoring
 sidebar:
-  order: 6
+  order: 5
   group: 
     hideIndex: true
 

src/content/docs/api-shield/reference/index.mdx

@@ -2,7 +2,7 @@
 pcx_content_type: reference
 title: Reference
 sidebar:
-  order: 7
+  order: 6
   group: 
     hideIndex: true