WAF Müşteri API'si
Müşteri API'si, kendi Web Protection hesabınızın sitelerini yönetir.
Bağlanma
- Adres:
https://waf.wireshield.network/api/v1 - Token: WS Portal'dan WAF panelini açın (Hizmetlerim → Manage WAF), API Ayarları'na girin ve bir anahtar oluşturun.
wsapi_ile başlar ve bir kez gösterilir. Müşteri hesabının ürettiği anahtar yalnızca müşteri API'sini açar. - Başlık:
Authorization: Bearer wsapi_…
curl https://waf.wireshield.network/api/v1/domains -H "Authorization: Bearer wsapi_..."
İstek ve yanıtlar JSON'dur. Zamanlar ISO 8601, UTC'dir. Hata, HTTP durum kodu ve {"detail": "..."} olarak gelir. Programınızda durum koduna bakın, mesaj metni değişebilir.
| Kod | Anlamı |
|---|---|
400 | Geçersiz değer ya da limit dolu (örneğin paketinizin site sayısı) |
401 | Anahtar yok, yanlış ya da hesap kapalı |
403 | Bu anahtarın yetkisi yok ya da paketinizde özellik yok |
404 | Yok ya da size ait değil |
422 | Gövde şemaya uymuyor: detail alanı söyler |
Siteler
POST /domains
Site ekler. Paketinizin site sınırına bakar.
| Alan | Tür | Zorunlu | Anlamı |
|---|---|---|---|
domain | string | evet | Alan adı |
backend_address | string | evet | Kaynak sunucu (IP ya da ad) |
backend_port | int | hayır | Varsayılan 80 |
POST /api/v1/domains
{"domain": "blog.example.com", "backend_address": "203.0.113.20", "backend_port": 80}
Yanıtta sitenin id, domain, is_active, waf_enabled, ssl_status ve created_at alanları vardır.
GET /domains ve GET /domains/{id}
Sitelerinizi listeler ya da birini okur.
DELETE /domains/{id}
Siteyi siler.
Kaynak sunucular
| Çağrı | Ne yapar |
|---|---|
GET /domains/{id}/backends | Sitenin kaynak sunucularını listeler |
POST /domains/{id}/backends | Bir tane ekler: address (IP ya da ad), port (1–65535), weight (1–100) |
DELETE /domains/{id}/backends/{backend_id} | Bir tanesini siler. Son sunucu silinemez |
Challenge ve WAF
| Çağrı | Ne yapar |
|---|---|
GET /domains/{id}/challenge | Sitenin varsayılan challenge'ı ve seçenekler |
PUT /domains/{id}/challenge | Gövde {"default_challenge": "none" | "js_challenge" | "captcha"} |
PUT /domains/{id}/waf?enabled=true | Korumayı açar (false = kapatır) |
curl -X PUT "https://waf.wireshield.network/api/v1/domains/$DOMAIN_ID/challenge" \
-H "Authorization: Bearer $WAF_KEY" -H "Content-Type: application/json" \
-d '{"default_challenge": "js_challenge"}'
Bayi API'sinde sitelerle ilgili daha fazla çağrı vardır (DNS denetimi, sertifika, lokasyon). Bkz. WAF Bayi API'si.