AS216394 · WireShield

Dokümantasyon

Kurulum, bağlantı ve günlük operasyon rehberleri.

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.

KodAnlamı
400Geçersiz değer ya da limit dolu (örneğin paketinizin site sayısı)
401Anahtar yok, yanlış ya da hesap kapalı
403Bu anahtarın yetkisi yok ya da paketinizde özellik yok
404Yok ya da size ait değil
422Gövde şemaya uymuyor: detail alanı söyler

Siteler

POST /domains

Site ekler. Paketinizin site sınırına bakar.

AlanTürZorunluAnlamı
domainstringevetAlan adı
backend_addressstringevetKaynak sunucu (IP ya da ad)
backend_portinthayırVarsayı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}/backendsSitenin kaynak sunucularını listeler
POST /domains/{id}/backendsBir 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}/challengeSitenin varsayılan challenge'ı ve seçenekler
PUT /domains/{id}/challengeGövde {"default_challenge": "none" | "js_challenge" | "captcha"}
PUT /domains/{id}/waf?enabled=trueKorumayı 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.

Bu rehberle ilgili sorunuz mu var?
Teknik ekibe sorun