Test Ortam IP Whitelist Yönetimi

Bu servisler ile STAGE ortamına erişim için satıcı hesabınıza ait IP whitelist kayıtlarını listeleyebilir, yeni IPv4
adresi ekleyebilir ve mevcut bir IP kaydını silebilirsiniz. Whitelist’te tanımlı IP’ler üzerinden stage
entegrasyon erişimi yönetilir.

Servis Kuralları

• Bu servis stage ortamına erişim için IP yetkilendirmesi sağlamak amacıyla kullanılır.
• Tüm endpoint’ler Basic Authentication ile çağrılmalıdır.
• Path’teki sellerId, satıcı panelindeki satıcı ID bilgisidir ve zorunludur.
• Yalnızca IPv4 adresleri desteklenir (örn. 203.0.113.10). IPv6 kabul edilmez.
• Whitelist’e maksimum 7 adet IP eklenebilir.
• Günlük en fazla 7 adet IP oluşturma (ekleme) isteği gönderilebilir.
• Eklenen IP’ler için sistem bir son geçerlilik tarihi (expiresAt) üretir; süre dolunca kayıt geçersiz olur.
• İşlem veya tanımlı IP sayısı limiti aşıldığında 429 döner.
  

1-IP Whitelist Listeleme

Satıcıya ait, stage ortam erişimi için tanımlı aktif IP whitelist kayıtlarını listeler.

• Query parametresi yoktur; satıcıya ait tüm whitelist kayıtları döner.
• Her kayıt için IP adresi ve son geçerlilik tarihi (expiresAt) döner.
• Kayıt yoksa ips boş dizi olarak dönebilir.
• Whitelist’te aynı anda en fazla 7 IP bulunabilir

GET ip-whitelists

Servis Parametresi

Örnek Servis Cevabı

{
"sellerId": "123456",
"ips": [
{
"ip": "203.0.113.10",
"expiresAt": "2026-08-16T08:19:53.084130217Z"
}
]
}

Alan Açıklamaları (Response)

Hata Senaryoları

2-IP Whitelist Ekleme

Stage ortamına erişim için satıcı whitelist’ine yeni bir IPv4 adresi ekler.

Servis Kuralları

• Request body’de yalnızca ip alanı gönderilir.
• IP zorunludur ve geçerli bir IPv4 olmalıdır.
• Whitelist’te maksimum 7 adet IP tutulabilir; bu limit aşıldığında istek reddedilir.
• Günlük en fazla 7 adet IP oluşturma isteği gönderilebilir; günlük limit aşıldığında istek reddedilir.
• Aynı IP zaten aktifse 409 döner.
• Güvenlik kontrolü başarısız olursa 422 döner.
• Limit aşımında (maks. 7 IP veya günlük 7 ekleme) 429 döner.
• Başarılı işlemde HTTP 201 ve eklenen kaydın expiresAt bilgisi döner.

POST ip-whitelists

Servis Parametresi

Örnek Servis İsteği

{
  "ip": "1.1.1.1"
}

Alan Açıklamaları (Request)

Örnek Servis Cevabı HTTP 201

{
  "sellerId": "123456",
  "ip": "203.0.113.10",
  "expiresAt": "2026-08-16T08:19:53.084130217Z"
}

Alan Açıklamaları (Response)

Hata Senaryoları

3- IP Whitelist Silme

Satıcı whitelist’inden belirtilen IPv4 adresini siler; stage erişim yetkisi ilgili IP için kaldırılır.

• Silinecek IP path parametresi olarak gönderilir.
• Başarılı silmede HTTP 204 döner; response body yoktur.
• Silinmek istenen IP bulunamazsa 404 döner.
• Limit aşımında 429 döner.
• Silinen IP, maksimum 7 IP kotasında yer açar; günlük oluşturma limiti (7/gün) silme ile sıfırlanmaz.

DELETE ip-whitelist

Servis Parametresi

Hata Senaryoları