WAF Bayi API'si
Bayi API'si, Web Protection'ın birçok müşterisini kendi portalınızdan ya da faturalama sisteminizden yönetir. Yalnızca sizin açtığınız müşterileri görürsünüz. Bayi hesabını WireShield talep üzerine açar: bize ulaşın.
Bağlanma
- Adres:
https://waf.wireshield.network/api/v1 - Token: bayi panelinde API Ayarları.
wsapi_ile başlar ve bir kez gösterilir. - Başlık:
Authorization: Bearer wsapi_… - Hatalar, limitler ve biçimler WAF Müşteri API'si ile aynıdır. Limitte
nullsınırsız,0hiç yok demektir.
Tipik akış
- Satış: paketle
POST /customers, ardındanPOST /customers/{id}/domains. Yanıttakidnshedefini müşteriye gösterin. - DNS: müşteri DNS'ini değiştirir.
GET /customers/{id}/domains/{domain_id}/dns-checkne zaman geldiğini söyler; sertifika kendiliğinden alınır (ya daPOST …/sslile hemen istenir). - Giriş:
POST /customers/{id}/login-link, WAF paneline parolasız açan tek kullanımlık bir adres döner (15 dakika). Tıklama anında üretin. - Faturalama: ay sonunda
GET /usage?month=YYYY-MM. - Ödeme yoksa:
POST /customers/{id}/suspend, ödenince…/unsuspend.DELETE /customers/{id}hizmeti bitirir (?permanent=trueher şeyi siler).
Paketler ve müşteriler
| Çağrı | Ne yapar |
|---|---|
GET /plans | Verebileceğiniz paketler, limitleriyle (sites, custom_rules, rate_limit_rules, captcha_monthly, captcha_keys) ve özellikleriyle |
POST /customers | Müşteri açar: email, name, plan_id, isteğe bağlı password ya da send_invite |
GET /customers, GET /customers/{id} | Listeler, okur |
PUT /customers/{id} | Paketi ({"plan_id": "…"}) ve limitleri değiştirir. Hesap aynı kalır, anahtarları silinmez |
DELETE /customers/{id} | Hizmeti bitirir |
POST /customers/{id}/login-link | Tek kullanımlık giriş adresi |
POST /customers/{id}/suspend · unsuspend | Müşteriyi kapatır / açar |
POST /api/v1/customers
{"email": "ali@example.com", "name": "Example Ltd", "plan_id": "f980842a-e67c-4d9a-9456-65e4f6ffdc95", "send_invite": false}
Bir e-posta adresinin WAF panelinde yalnızca bir hesabı olabilir. Bayiniz dışında açılmış hesabı olan bir müşteri yeniden açılamaz: o hesabı sizin altınıza taşımamızı isteyin.
Müşterinin siteleri
| Çağrı | Ne yapar |
|---|---|
GET /customers/{id}/locations | Paketin seçmeye izin verdiği lokasyonlar (enabled: false = en uygun düğüm kullanılır) |
POST /customers/{id}/domains | Site ekler: domain, isteğe bağlı backend_servers (address, port, weight), location_id, www_redirect (none, www_to_main, main_to_www). Yanıtta dns vardır |
GET /customers/{id}/domains, …/{domain_id} | Listeler, okur |
GET …/{domain_id}/dns-check | DNS geldi mi |
POST …/{domain_id}/ssl | Sertifikayı hemen ister |
POST …/{domain_id}/backends, DELETE …/backends/{backend_id} | Kaynak sunucular (en çok 20) |
PUT …/{domain_id}/waf?enabled=true | Koruma açık / kapalı |
DELETE …/{domain_id} | Siteyi siler |
Kullanım
GET /usage?month=YYYY-MM ayın bütün müşterilerini tek çağrıda verir: paket, site sayısı, traffic (requests, blocked, challenged, bytes) ve captcha_verifications. GET /customers/{id}/usage aynısını tek müşteri için verir.
wsCAPTCHA
| Çağrı | Ne yapar |
|---|---|
GET /customers/{id}/captcha | Anahtarlar ve bu ayın kullanımı (pakete göre) |
POST /customers/{id}/captcha/keys | Anahtar oluşturur (name, domains). Yanıtta site anahtarı ve bir kez gösterilen gizli anahtar vardır |
PUT /customers/{id}/captcha/keys/{key_id} | Ad, alan adları, açık/kapalı |
POST /customers/{id}/captcha/keys/{key_id}/secret | Yeni gizli anahtar üretir |
GET …/{key_id}/stats?period=24h ya da 7d | Sayılar |
GET …/{key_id}/events?limit=100 | Doğrulama kaydı |
DELETE …/{key_id} | Anahtarı siler |
Doğrulamanın kendisi wsCAPTCHA entegrasyon rehberinde anlatılır.