Tüm Ürünler
Search

Bu Ürün

    API Gateway:Key-rate-limit

    Belge Merkezi

    API Gateway:Key-rate-limit

    Son Güncelleme:Oct 04, 2026

    Key-rate-limit eklentisi, URL parametrelerinden veya HTTP istek üstbilgilerinden alınan belirli anahtar değerlerine göre istekleri kısıtlar.

    Eklenti türü

    Kısıtlama eklentisi.

    Alanlar


    Alan


    Veri türü


    Gerekli mi?


    Varsayılan değer


    Açıklama


    limit_by_header


    string


    Hayır. limit_by_header veya limit_by_param alanlarından birini yapılandırmanız gerekir.


    -


    Kısıtlama anahtarı değerini sağlayan HTTP istek üstbilgisi.


    limit_by_param


    string


    Hayır. limit_by_header veya limit_by_param alanlarından birini yapılandırmanız gerekir.


    -


    Kısıtlama anahtarı değerini sağlayan URL parametresi.


    limit_keys


    array of object


    Evet


    -


    Belirli anahtar değerleri için hız sınırlama kuralları.

    limit_keys nesnesindeki alanlar:


    Yapılandırma öğesi


    Veri türü


    Gerekli mi?


    Varsayılan değer


    Açıklama


    key


    string


    Evet


    -


    Gelen isteklerle eşleştirilecek değer.


    query_per_second


    number


    Hayır. query_per_second, query_per_minute, query_per_hour veya query_per_day alanlarından birini yapılandırmanız gerekir.


    -


    Saniye başına izin verilen maksimum istek sayısı.


    query_per_minute


    number


    Hayır. query_per_second, query_per_minute, query_per_hour veya query_per_day alanlarından birini yapılandırmanız gerekir.


    -


    Dakika başına izin verilen maksimum istek sayısı.


    query_per_hour


    number


    Hayır. query_per_second, query_per_minute, query_per_hour veya query_per_day alanlarından birini yapılandırmanız gerekir.


    -


    Saat başına izin verilen maksimum istek sayısı.


    query_per_day


    number


    Hayır. query_per_second, query_per_minute, query_per_hour veya query_per_day alanlarından birini yapılandırmanız gerekir.


    -


    Gün başına izin verilen maksimum istek sayısı.

    Örnekler

    • İstek üstbilgisindeki x-ca-key anahtar değerine göre istekleri kısıtlayın.

      limit_by_header: x-ca-key
limit_keys:
- key: 102234
  query_per_second: 10
- key: 308239
  query_per_hour: 10

    • İstek parametresindeki apikey anahtar değerine göre istekleri kısıtlayın.

      limit_by_param: apikey
limit_keys:
- key: 9a342114-ba8a-11ec-b1bf-00163e1250b5
  query_per_second: 10
- key: a6a6d7f2-ba8a-11ec-bec2-00163e1250b5
  query_per_minute: 100

    • Belirli rotalar veya alan adları için kısıtlamayı etkinleştirin.

      Aşağıdaki eklenti yapılandırmalarını route-a ve route-b rotalarına uygulayın:

        limit_by_header: x-ca-key
  limit_keys:
  - key: 102234
    query_per_second: 10

      Aşağıdaki eklenti yapılandırmasını *.example.com ve test.com alan adlarına uygulayın:

        limit_by_header: x-ca-key
  limit_keys:
  - key: 102234
    query_per_second: 100
      Not

      • route-a ve route-b ifadeleri, ağ geçidi rotaları oluşturulurken belirtilen rotaları ifade eder. Bir istek bu rotalardan biriyle eşleşirse ilgili kurallar uygulanır.

      • *.example.com ve test.com ifadeleri istek alan adlarıyla eşleşir. Bir istek bu alan adlarından biriyle eşleşirse ilgili kurallar uygulanır.

      • Kurallar sırayla uygulanır. İlk kural eşleştiğinde sonraki kurallar dikkate alınmaz.