ZuploZuplo
LoginStart for Free
  • Documentation
  • API Reference
Getting Started
Concepts
API Management
    Overview
    Getting Started
      1 - Set up a basic gateway
        2 - Add rate limiting
          3 - Add API key authentication
            4 - Deploy to the edge
              5 - Dynamic rate limiting
              API Keys
              Rate Limiting
              Caching
              GraphQL
              Monetization
              Policies
              Handlers
            AI Gateway
            MCP Gateway
            MCP Server
            Developer Portal
            Development
            Deploying & Source Control
            Analytics
            Observability
            Networking & Infrastructure
            Account Management
            Programming API
            Build with AI
            Zuplo CLI
            Migration Guides
            Platform LimitsVersion Support PolicySecuritySupportTrust & ComplianceChangelog
            powered by Zuplo
            API Management

            Add rate limiting - Portal

            1. Choose a productAPI Gateway
            2. Choose a workflowZuplo Portal
            3. 3Build and testStep 2 of 5

            API Gateway tutorial/Zuplo Portal/Step 2 of 5

            Limit requests from each IP address, then test that requests over the limit return a 429 response.

            Before you start: Start with a working route from the gateway setup step. Set up a basic gateway

            Follow along using

            Zuplo PortalLocal with an editorLocal with an AI agent

            In this guide we'll add simple Rate Limiting to a route. If you don't have one ready, complete Step 1 first.

            Rate Limiting is one of our most popular policies - you should never ship an API without rate limiting because your customers or internal developers will accidentally DoS your API; usually with a rogue useEffect call in React code.

            What's a Policy?

            Policies are modules that can intercept and transform an incoming request or outgoing response. Zuplo offers a wide range of policies built-in (including rate limiting) to save you time. You can check out the full list.

            Zuplo offers a programmable approach to rate limiting that allows you to vary how rate limiting is applied for each customer, or requests.

            In this example, we'll add a simple IP based rate limiter, but you should look into dynamic rate limiting to see the full power of the world's best rate limiter.

            1. Add the rate-limiting Policy

              Navigate to your route in the Route Designer (Code > routes.oas.json), click the Policies dropdown, then click Add Policy on the request pipeline.

              Add policy

              Search for the rate limiting policy (not the "Complex" one) and click it.

              Add rate-limiting policy

              By default, the policy will rate limit based on the caller's IP address (as indicated by the rateLimitBy field). It will allow 2 requests (requestsAllowed) every 1 minute (timeWindowMinutes). You can explore the rest of the policy's documentation and configuration in the right panel.

              Rate limiting policy

              To apply the policy, click OK. Then, save your changes to redeploy.

            2. Testing your Policy

              Now try firing some requests against your API. You should receive a 429 Too many requests on your 3rd request.

              429 response

              Your rate limiting policy is now intercepting excess requests, protecting the echo API.

            Set up a basic gatewayAdd API key authentication
            On this page
            • Add the rate-limiting Policy
            • Testing your Policy