Tüm Ürünler
Search
Belge Merkezi

API Gateway:Custom-response

Son Güncelleme:Oct 04, 2026

Custom-response plug-in'i özel HTTP durum kodları, üst bilgiler ve gövdeler döndürür. Bu plug-in'i sahte yanıtlar oluşturmak veya belirli durum kodlarına yönelik yanıtları geçersiz kılmak için kullanabilirsiniz; örneğin, bir kısıtlama ilkesi tetiklendiğinde özel bir ileti döndürebilirsiniz.

Plug-in türü

İletişim protokolüyle ilgili plug-in.

Alanlar


Alan


Veri türü


Zorunlu


Varsayılan değer


Açıklama


status_code


number


No


200


Özel HTTP durum kodu.


headers


array of string


No


-


Özel HTTP yanıt üst bilgileri. Her anahtar-değer çiftini = ile ayırın.


body


string


No


-


Özel HTTP yanıt gövdesi.


enable_on_status


array of number


No


-


Özel yanıtı tetikleyen HTTP durum kodu. Bu alanı boş bırakırsanız, özel yanıt özgün durum kodundan bağımsız olarak tüm isteklere uygulanır.

Örnekler

Sahte yanıt senaryolarında özel bir yanıt döndürme

status_code: 200
headers:
- Content-Type=application/json
- Hello=World
body: "{\"hello\":\"world\"}"

Bu yapılandırma aşağıdaki yanıtı döndürür:

HTTP/1.1 200 OK
Content-Type: application/json
Hello: World
Content-Length: 17

{"hello":"world"}

Kısıtlama tetiklendiğinde özel bir yanıt döndürme

enable_on_status: 
- 429
status_code: 302
headers:
- Location=https://example.com

Kısıtlama genellikle HTTP durum kodu 429 döndürür. Bu yapılandırmayla ağ geçidi bunun yerine aşağıdaki özel yanıtı verir:

HTTP/1.1 302 Found
Location: https://example.com

Bu sayede kısıtlanan istekler başka bir sayfaya, örneğin CDN üzerindeki statik bir sayfaya yönlendirilir.

Kısıtlama tetiklendiğinde farklı durum kodları döndürmek için "Sahte yanıt senaryolarında özel bir yanıt döndürme" bölümünde açıklanan alanları yapılandırın.

Belirli rotalar veya alan adları için istekleri engelleme

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

body: "{\"hello\":\"world\"}"

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

  enable_on_status: 
  - 429
  status_code: 200
  headers:
  - Content-Type=application/json
  body: "{\"errmsg\": \"rate limited\"}"
Not
  • route-a ve route-b ağ geçidi rotaları oluşturulurken belirtilen rotalardır. Bir istek bir rota ile eşleşirse o rota için yapılandırılan kurallar yürütülür.

  • *.example.com ve test.com isteklerdeki alan adlarıyla eşleşir. Bir istek bir alan adıyla eşleşirse o alan adı için yapılandırılan kurallar yürütülür.

  • Kurallar sırayla uygulanır. Bir kural eşleştiğinde sonraki kurallar atlanır.