API Metotları ve Endpoint'ler
Nexren Shield Cloud Edge Security & WAF mimarisi için kapsamlı REST API referansı. Tüm HTTP istekleri JSON formatında kabul edilir ve Bearer Token ile yetkilendirilir.
https://shield.nexren.info/api/v1
Languages
Gönderilecek isteklerde varsayılan olarak görüntülenecek programlama dilini seçin:
AI Agent & LLM Entegrasyonu
Cursor, Claude Code, Antigravity, Windsurf veya ChatGPT için hazır ajan kurulum talimatını tek tıkla kopyalayın.
HTTP Durum Kodları Kataloğu
Olası HTTP yanıt kodları, anlamları ve geliştirici çözüm yolları.
| HTTP Kodu | Durum | Açıklama & Çözüm |
|---|---|---|
200 OK | Başarılı | İstek başarıyla işlendi ve beklenen veri nesnesi döndürüldü. |
201 Created | Oluşturuldu | Yeni kaynak (Web Sitesi, API Tokenı vb.) başarıyla oluşturuldu. |
204 No Content | İçerik Yok | İşlem başarıyla tamamlandı, yanıt gövdesinde veri döndürülmez. |
400 Bad Request | Hatalı İstek | Eksik parametre, hatalı JSON sözdizimi veya doğrulanamayan payload formatı. İstek gövdesini kontrol edin. |
401 Unauthorized | Yetkisiz | API Token anahtarı eksik, geçersiz veya süresi dolmuş. Authorization: Bearer nx_live_... başlığını doğrulayın. |
403 Forbidden | Yasaklandı | Kullanılan API Token'ının yetki kapsamı (Scope) bu işlem için yetersiz veya IP kısıtlaması uyuşmuyor. |
404 Not Found | Bulunamadı | Belirtilen domain veya ID'ye sahip web sitesi ya da token bulunamadı (Strict Tenant İzolasyonu gereği diğer kullanıcılara ait nesneler 404 döner). |
409 Conflict | Çakışma | Eklenmek istenen domain veya kaynak hesabınızda zaten kayıtlı. |
429 Too Many Requests | Hız Sınırı Aşıldı | Dakikalık 120 istek kotası aşıldı. X-RateLimit-Reset süresini bekleyin. |
500 Internal Error | Sunucu Hatası | Sunucu tarafında beklenmeyen bir hata meydana geldi. |
502 Bad Gateway | Geçersiz Ağ Geçidi | Origin sunucunuza ulaşılamadı veya bağlantı zaman aşımına uğradı. |
Web Sitelerini Listele
Hesabınıza tanımlı tüm web sitelerinin listesini, aktif koruma modlarını (Off, Monitor, Balanced, Under Attack), origin hedeflerini, SSL durumlarını ve trafik özetini döndürür.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Sorgu Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
includePending |
boolean | Opsiyonel |
search |
string | Opsiyonel |
curl -s -X GET "https://shield.nexren.info/api/v1/sites" \
-H "Authorization: Bearer $NEXREN_API_KEY"
Yeni Web Sitesi Ekle
Nexren Shield WAF ve DDoS koruma kalkanına yeni bir alan adı (domain) ekler. Otomatik SSL provizyonunu başlatır ve koruma modunu belirler.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Content-Type |
string | Zorunlu |
İstek Gövdesi
| Alan | Tür | Durum |
|---|---|---|
domain |
string | Zorunlu |
originUrl |
string | Zorunlu |
mode |
string | Opsiyonel |
curl -s -X POST "https://shield.nexren.info/api/v1/sites" \
-H "Authorization: Bearer $NEXREN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"domain": "example.com",
"originUrl": "https://198.51.100.25:443",
"mode": "Balanced"
}'
Web Sitesi Detayları
Belirtilen domain adı (örn: 'example.com') veya Site ID'sine sahip sitenin detaylı durumunu, DNS yönlendirme hedefini, Origin bağlantı durumunu ve aktif WAF kural sayısını getirir.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
curl -s -X GET "https://shield.nexren.info/api/v1/sites/{id}" \
-H "Authorization: Bearer $NEXREN_API_KEY"
Site Ayarlarını Güncelle
Sitenin koruma modunu (Off, Monitor, Balanced, Under Attack) anında değiştirin, kalkanı duraklatın veya origin sunucu adresini güncelleyin.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Content-Type |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
İstek Gövdesi
| Alan | Tür | Durum |
|---|---|---|
mode |
string | Opsiyonel |
originUrl |
string | Opsiyonel |
enabled |
boolean | Opsiyonel |
curl -s -X PATCH "https://shield.nexren.info/api/v1/sites/{id}" \
-H "Authorization: Bearer $NEXREN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"mode": "Under Attack"
}'
Web Sitesini Sil
Web sitesini ve ilişkili tüm WAF kurallarını, SSL sertifikalarını ve önbellek yapılandırmasını Nexren Shield kalkanından tamamen kaldırır.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
curl -s -X DELETE "https://shield.nexren.info/api/v1/sites/{id}" \
-H "Authorization: Bearer $NEXREN_API_KEY"
Önbelleği Temizle (Purge Cache)
Sitenin kenar statik dosya önbelleğini temizler (tümü ya da verilen yollar; sondaki * önek eşleşmesidir). Kenarda en geç ~1 sn içinde etkili olur. Yanıttaki kayıt/bayt sayıları gerçektir: kenarın son raporundaki (en çok ~30 sn eski, an countsAsOf) önbellek içeriği. Sayı bilinmiyorsa (rapor yok, rapor önceki temizlemeden eski, ya da yol kapsamında eşleşme sayısı raporlanmıyor) entries/bytes/purgedSize null, countsExact false olur ve neden countsUnknownReason'da yazar — asla uydurma 0 dönmez. Tüm site YALNIZ {"purgeAll": true} (paths olmadan) ya da boş gövde / {} ile temizlenir. Geçersiz gövde 400 döner ve hiçbir şey temizlenmez: bozuk JSON, null ya da nesne olmayan gövde, tanınmayan alan (ör. "path"), null / dizi olmayan / boş paths, yol olarak '*' ya da '/*' (purgeAll:true kullanın), boolean olmayan purgeAll (null dahil), purgeAll:true ile birlikte paths ya da purgeAll:false ile yol verilmemesi.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Content-Type |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
İstek Gövdesi
| Alan | Tür | Durum |
|---|---|---|
purgeAll |
boolean | Opsiyonel |
paths |
array | Opsiyonel |
curl -s -X POST "https://shield.nexren.info/api/v1/sites/{id}/purge-cache" \
-H "Authorization: Bearer $NEXREN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"purgeAll": true
}'
Origin Bilgisini Al
Sitenin backend kaynak sunucu IP/Hostname adresini, bağlantı zaman aşımı değerlerini ve Origin Lock güvenlik kilidi durumunu döndürür.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
curl -s -X GET "https://shield.nexren.info/api/v1/sites/{id}/origin" \
-H "Authorization: Bearer $NEXREN_API_KEY"
Origin Yapılandırmasını Güncelle
Backend sunucu adresini, portunu veya Host başlığı iletim ayarlarını günceller.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Content-Type |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
İstek Gövdesi
| Alan | Tür | Durum |
|---|---|---|
url |
string | Zorunlu |
hostHeader |
string | Opsiyonel |
timeoutSec |
integer | Opsiyonel |
curl -s -X PUT "https://shield.nexren.info/api/v1/sites/{id}/origin" \
-H "Authorization: Bearer $NEXREN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://198.51.100.25:443",
"timeoutSec": 30
}'
Origin Lock Aç / Kapat
Origin Lock özelliğini açıp kapatır. Origin Lock aktif olduğunda kaynak sunucunuz sadece Nexren Shield'ın gizli kriptografik anahtar başlığını içeren isteklere yanıt verir; doğrudan IP saldırılarını engeller.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Content-Type |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
İstek Gövdesi
| Alan | Tür | Durum |
|---|---|---|
enabled |
boolean | Zorunlu |
curl -s -X POST "https://shield.nexren.info/api/v1/sites/{id}/origin/lock/toggle" \
-H "Authorization: Bearer $NEXREN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"enabled": true
}'
Origin Lock Sunucu Kod Parçacıkları
Nginx, Apache, PHP (WordPress), Caddy, Cloudflare Custom Rules, UFW ve Iptables için sitenize özel kriptografik başlık ve gizli anahtarla hazır kopyala-yapıştır koruma yapılandırmalarını döndürür.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
curl -s -X GET "https://shield.nexren.info/api/v1/sites/{id}/origin/lock/snippets" \
-H "Authorization: Bearer $NEXREN_API_KEY"
Origin Lock Canlı Doğrulama
Kaynak sunucunuzun doğrudan IP bağlantılarını reddettiğini ve yalnızca Nexren Shield kriptografik imzalı istekleri kabul ettiğini test eder ve kalkanı kilitler.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
curl -s -X POST "https://shield.nexren.info/api/v1/sites/{id}/origin/lock/verify" \
-H "Authorization: Bearer $NEXREN_API_KEY"
Politika Ayarlarını Al
Sitenin aktif güvenlik politikasını, rate limiting eşiklerini, bot koruma duyarlılığını ve özel kural listesini getirir.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
curl -s -X GET "https://shield.nexren.info/api/v1/policies/{id}" \
-H "Authorization: Bearer $NEXREN_API_KEY"
Politika & WAF Kurallarını Güncelle
Siteye ait WAF ve hız kısıtlama eşiklerini, bot koruma mekanizmalarını veya ülke engelleme listelerini tek istekte günceller.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Content-Type |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
İstek Gövdesi
| Alan | Tür | Durum |
|---|---|---|
rateLimitRps |
integer | Opsiyonel |
challengeBotDDoS |
boolean | Opsiyonel |
blockTorProxies |
boolean | Opsiyonel |
curl -s -X PUT "https://shield.nexren.info/api/v1/policies/{id}" \
-H "Authorization: Bearer $NEXREN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"rateLimitRps": 100,
"challengeBotDDoS": true
}'
WAF İstisnalarını Listele
Belirli WAF kurallarını sadece belirli URL yollarında ve HTTP metotlarında esneten kural istisnalarını satır biçiminde getirir. v4.10.231'den beri istisnalar özel kural olarak saklanır (eylem skip + wafRules); bu uç onların satır görünümüdür.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
curl -s -X GET "https://shield.nexren.info/api/v1/sites/{id}/waf/exceptions" \
-H "Authorization: Bearer $NEXREN_API_KEY"
WAF İstisnalarını Güncelle
Satır satır formatta (<ruleId> <path> [methods]) WAF istisnalarını özel kural olarak kaydeder (diğer özel kurallar korunur; «Kurallar ve IP listeleri» düzenleme izni — rules:edit). Tüm siteyi kapsayan istisnalar (/* veya /) güvenlik gereği reddedilir.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Content-Type |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
İstek Gövdesi
| Alan | Tür | Durum |
|---|---|---|
raw |
string | Zorunlu |
curl -s -X PUT "https://shield.nexren.info/api/v1/sites/{id}/waf/exceptions" \
-H "Authorization: Bearer $NEXREN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"raw": "930120 /api/upload POST\n941100 /admin/* *"
}'
Kural İstisnasını Sil
Belirtilen kural ID'sini sitenin tüm kapsamlı istisnalarından (wafRules taşıyan özel kurallar) kaldırır.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
{ruleId} |
string | Zorunlu |
curl -s -X DELETE "https://shield.nexren.info/api/v1/sites/{id}/waf/exceptions/{ruleId}" \
-H "Authorization: Bearer $NEXREN_API_KEY"
İstisna Sözdizimini Doğrula
WAF istisna kurallarını kaydetmeden önce sözdizimi ve güvenlik kontrolünden geçirir.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Content-Type |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
İstek Gövdesi
| Alan | Tür | Durum |
|---|---|---|
raw |
string | Zorunlu |
curl -s -X POST "https://shield.nexren.info/api/v1/sites/{id}/waf/exceptions/validate" \
-H "Authorization: Bearer $NEXREN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"raw": "930120 /api/upload POST"
}'
Canlı Güvenlik Olayları & Saldırı Kayıtları
WAF tarafından engellenen veya filtrelenen şüpheli istekleri, saldırgan IP adreslerini, tespit edilen kural eşleşmelerini ve zaman damgalarını sorgular.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Sorgu Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
siteId |
string | Opsiyonel |
action |
string | Opsiyonel |
limit |
integer | Opsiyonel |
curl -s -X GET "https://shield.nexren.info/api/v1/events" \
-H "Authorization: Bearer $NEXREN_API_KEY"
Trafik & Tehdit Analitiği Özeti
İstek sayılarını (izin verilen, engellenen, doğrulamaya yönlendirilen, hız limitine takılan), tahmini bant genişliğini ve kenar önbelleği isabet oranını döndürür. cachedRatio gerçek bir ölçümdür: kenar süreçlerinin raporladığı isabet ÷ (isabet + ıska), süreç başlangıcından beri; önbelleğe uygun hiç istek yoksa null.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Sorgu Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
siteId |
string | Opsiyonel |
period |
string | Opsiyonel |
curl -s -X GET "https://shield.nexren.info/api/v1/analytics/summary" \
-H "Authorization: Bearer $NEXREN_API_KEY"
Sitenin Tünellerini Listele
Siteye tanımlanmış tüm ters origin tünellerini, canlı bağlantı durumlarını, agent sürümlerini ve anlık gecikmelerini listeler.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
curl -s -X GET "https://shield.nexren.info/api/v1/sites/{id}/tunnels" \
-H "Authorization: Bearer $NEXREN_API_KEY"
Yeni Nexren Tüneli Başlat
Yeni bir ters tünel kaydı oluşturur ve origin sunucunuzda nexren-agent çalıştırmanız için güvenli token anahtarı üretir.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Content-Type |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
İstek Gövdesi
| Alan | Tür | Durum |
|---|---|---|
name |
string | Zorunlu |
localTarget |
string | Opsiyonel |
curl -s -X POST "https://shield.nexren.info/api/v1/sites/{id}/tunnels" \
-H "Authorization: Bearer $NEXREN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "App Server 1",
"localTarget": "http://127.0.0.1:3000"
}'
Tünel Durumunu Al
Belirtilen tünelin bağlantı geçmişini, canlı akış sayısını ve ping gecikmesini getirir.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
{tunnelId} |
string | Zorunlu |
curl -s -X GET "https://shield.nexren.info/api/v1/sites/{id}/tunnels/{tunnelId}" \
-H "Authorization: Bearer $NEXREN_API_KEY"
Tüneli İptal Et (Revoke)
Tüneli anında kapatır ve yetki anahtarını kalıcı olarak iptal eder.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
{tunnelId} |
string | Zorunlu |
curl -s -X DELETE "https://shield.nexren.info/api/v1/sites/{id}/tunnels/{tunnelId}" \
-H "Authorization: Bearer $NEXREN_API_KEY"
Origin İletim Modunu Değiştir
Sitenin gelen istekleri doğrudan IP/URL origin sunucusuna mı ('direct') yoksa bağlı Nexren Tüneline mi ('tunnel') ileteceğini belirler.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Content-Type |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
İstek Gövdesi
| Alan | Tür | Durum |
|---|---|---|
originKind |
string | Zorunlu |
curl -s -X POST "https://shield.nexren.info/api/v1/sites/{id}/origin-kind" \
-H "Authorization: Bearer $NEXREN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"originKind": "tunnel"
}'
Tüm Tünelleri Listele
Hesabınıza bağlı tüm sitelerin tünellerini tek listede gösterir.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
curl -s -X GET "https://shield.nexren.info/api/v1/tunnels" \
-H "Authorization: Bearer $NEXREN_API_KEY"
DDoS & Hız Sınırlarını Al
Sitenin dakikalık/saniyelik rate limit kotalarını, burst eşiğini, bot challenge durumunu ve DDoS koruma seviyesini getirir.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
curl -s -X GET "https://shield.nexren.info/api/v1/sites/{id}/ddos" \
-H "Authorization: Bearer $NEXREN_API_KEY"
DDoS & Hız Sınırlarını Güncelle
RPS limitini, burst kapasitesini ve bot koruma eşiğini tek çağrıda günceller.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Content-Type |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
İstek Gövdesi
| Alan | Tür | Durum |
|---|---|---|
rateLimitRps |
integer | Opsiyonel |
rateLimitBurst |
integer | Opsiyonel |
ddosSensitivity |
string | Opsiyonel |
curl -s -X PUT "https://shield.nexren.info/api/v1/sites/{id}/ddos" \
-H "Authorization: Bearer $NEXREN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"rateLimitRps": 100,
"rateLimitBurst": 150,
"ddosSensitivity": "high"
}'
Acil DDoS Savunmasını Başlat
Siteyi anında 'Under Attack' acil durum moduna geçirir ve tüm gelen istekleri JS PoW / CAPTCHA ile filtreler.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
curl -s -X POST "https://shield.nexren.info/api/v1/sites/{id}/ddos/mitigate" \
-H "Authorization: Bearer $NEXREN_API_KEY"
Rate Limit Sayaçlarını Sıfırla
Siteye bağlı sliding-window rate limit sayaçlarını ve geçici IP kısıtlama tablolarını sıfırlar.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
curl -s -X POST "https://shield.nexren.info/api/v1/sites/{id}/ddos/reset" \
-H "Authorization: Bearer $NEXREN_API_KEY"
Bakım Modu Yapılandırmasını Al
Sitenin bakım modunda olup olmadığını, özel HTML şablonunu, tahmini bitiş zamanını (ETA) ve muaf tutulan IP listesini döndürür.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
curl -s -X GET "https://shield.nexren.info/api/v1/sites/{id}/maintenance" \
-H "Authorization: Bearer $NEXREN_API_KEY"
Bakım Modu Ayarlarını Güncelle
Bakım sayfasının HTML kodunu, muaf IP'leri, HTTP durum kodunu (503) ve aktifliğini ayarlar.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Content-Type |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
İstek Gövdesi
| Alan | Tür | Durum |
|---|---|---|
enabled |
boolean | Opsiyonel |
customHtml |
string | Opsiyonel |
bypassIps |
array | Opsiyonel |
eta |
string | Opsiyonel |
curl -s -X PUT "https://shield.nexren.info/api/v1/sites/{id}/maintenance" \
-H "Authorization: Bearer $NEXREN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"enabled": true,
"customHtml": "<h1>Bakım Çalışması</h1>",
"bypassIps": [
"198.51.100.5"
]
}'
Bakım Modunu Hızlı Aç / Kapat
Tek bir POST isteği ile bakım modunu anında açar veya kapatır.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
İstek Gövdesi
| Alan | Tür | Durum |
|---|---|---|
enabled |
boolean | Opsiyonel |
curl -s -X POST "https://shield.nexren.info/api/v1/sites/{id}/maintenance/toggle" \
-H "Authorization: Bearer $NEXREN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"enabled": true
}'
Bakım Sayfasını Önizle
Ziyaretçilere sunulacak bakım sayfası HTML tasarımını tarayıcıda önizler.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
curl -s -X GET "https://shield.nexren.info/api/v1/sites/{id}/maintenance/preview" \
-H "Authorization: Bearer $NEXREN_API_KEY"
Zero Trust Erişim Kurallarını Listele
Site için tanımlanmış yol bazlı kimlik doğrulama, TOTP 2FA ve IP kısıtlama kurallarını listeler.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
curl -s -X GET "https://shield.nexren.info/api/v1/sites/{id}/zt/access-rules" \
-H "Authorization: Bearer $NEXREN_API_KEY"
Zero Trust Erişim Kuralı Oluştur
Belirli bir URL yolu için TOTP 2FA veya IP bazlı erişim zorunluluğu tanımlar.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Content-Type |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
İstek Gövdesi
| Alan | Tür | Durum |
|---|---|---|
name |
string | Zorunlu |
pathPattern |
string | Zorunlu |
require2fa |
boolean | Opsiyonel |
curl -s -X POST "https://shield.nexren.info/api/v1/sites/{id}/zt/access-rules" \
-H "Authorization: Bearer $NEXREN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Admin Panel",
"pathPattern": "/admin/*",
"require2fa": true
}'
Zero Trust Erişim Kuralını Sil
Zero Trust erişim kuralını kalıcı olarak siler.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
{ruleId} |
string | Zorunlu |
curl -s -X DELETE "https://shield.nexren.info/api/v1/sites/{id}/zt/access-rules/{ruleId}" \
-H "Authorization: Bearer $NEXREN_API_KEY"
Zero Trust 2FA TOTP Doğrulaması
Kullanıcının kimlik doğrulayıcı uygulamasından girdiği 6 haneli TOTP kodunu doğrular.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Content-Type |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
{userId} |
string | Zorunlu |
İstek Gövdesi
| Alan | Tür | Durum |
|---|---|---|
token |
string | Zorunlu |
curl -s -X POST "https://shield.nexren.info/api/v1/sites/{id}/zt/users/{userId}/verify-2fa" \
-H "Authorization: Bearer $NEXREN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"token": "123456"
}'
Aktif Zero Trust Oturumlarını Listele
Sitede kimliği doğrulanmış aktif personelin oturumlarını ve zaman aşımı sürelerini gösterir.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
curl -s -X GET "https://shield.nexren.info/api/v1/sites/{id}/zt/sessions" \
-H "Authorization: Bearer $NEXREN_API_KEY"
Zero Trust Oturumlarını İptal Et
Belirli bir kullanıcının veya tüm personelin aktif oturumlarını tek çağrıyla sonlandırır.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
İstek Gövdesi
| Alan | Tür | Durum |
|---|---|---|
email |
string | Opsiyonel |
curl -s -X POST "https://shield.nexren.info/api/v1/sites/{id}/zt/sessions/revoke" \
-H "Authorization: Bearer $NEXREN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"email": "user@example.com"
}'
Site DDoS Olaylarını Listele
Siteye yönelik kaydedilen volumetrik ve Layer 7 flood saldırı olaylarının başlangıç, bitiş, tepe RPS ve engelleme raporlarını döndürür.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
curl -s -X GET "https://shield.nexren.info/api/v1/sites/{id}/incidents" \
-H "Authorization: Bearer $NEXREN_API_KEY"
Tüm Hesap DDoS Olaylarını Listele
Hesabınıza bağlı tüm siteler genelindeki DDoS saldırı kayıtlarını listeler.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
curl -s -X GET "https://shield.nexren.info/api/v1/incidents" \
-H "Authorization: Bearer $NEXREN_API_KEY"
Gerçek Zamanlı Engellenen Tehdit Akışı
Edge düğümlerinde engellenen saldırıların canlı akışını, gizlenmiş istemci IP'lerini, ülkelerini ve tetiklenen WAF kurallarını döndürür.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Sorgu Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
siteId |
string | Opsiyonel |
limit |
integer | Opsiyonel |
curl -s -X GET "https://shield.nexren.info/api/v1/threats/live" \
-H "Authorization: Bearer $NEXREN_API_KEY"
Tehdit Kategorisi Analiz Özeti
Engellenen saldırıların kategorilerine (SQLi, XSS, RCE, Bot, DDoS vb.) göre sayısal ve yüzdesel dağılımını özetler.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Sorgu Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
siteId |
string | Opsiyonel |
period |
string | Opsiyonel |
curl -s -X GET "https://shield.nexren.info/api/v1/threats/summary" \
-H "Authorization: Bearer $NEXREN_API_KEY"
Site Güvenlik Denetim Kayıtları
Sitede gerçekleştirilen kural değişiklikleri, SSL yenilemeleri, mod güncellemeleri ve API çağrılarının denetim izini listeler.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{id} |
string | Zorunlu |
Sorgu Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
limit |
integer | Opsiyonel |
curl -s -X GET "https://shield.nexren.info/api/v1/sites/{id}/audit-logs" \
-H "Authorization: Bearer $NEXREN_API_KEY"
Hesap Genel Denetim Kayıtları
Hesap genelinde gerçekleştirilen tüm işlemlerin zaman damgalı, aktör ve IP kayıtlı denetim geçmişini getirir.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Sorgu Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
category |
string | Opsiyonel |
search |
string | Opsiyonel |
curl -s -X GET "https://shield.nexren.info/api/v1/audit-logs" \
-H "Authorization: Bearer $NEXREN_API_KEY"
Tekil Denetim Kaydı Detayını Al
Belirtilen denetim kaydının aktör, IP, istek parametreleri ve durum detaylarını gösterir.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
Yol Parametreleri
| Parametre | Tür | Durum |
|---|---|---|
{logId} |
string | Zorunlu |
curl -s -X GET "https://shield.nexren.info/api/v1/audit-logs/{logId}" \
-H "Authorization: Bearer $NEXREN_API_KEY"
Aktif Token & Yetki Durumu
İstekte kullanılan API Token anahtarının geçerliliğini, atanmış yetki kapsamlarını (scopes), istemci IP adresini ve güncel dakikalık rate limit durumunu doğrular.
İstek Başlıkları (Request Headers)
| Başlık | Tür | Durum |
|---|---|---|
Authorization |
string | Zorunlu |
curl -s -X GET "https://shield.nexren.info/api/v1/whoami" \
-H "Authorization: Bearer $NEXREN_API_KEY"