API Token Bağlantısı

Token girildiğinde aşağıdaki tüm canlı "Try It Out" testleri bu anahtarla çalışır.

Nexren Shield REST API (v1)

Nexren Shield Developer API, web sitelerinizin güvenliğini, WAF ve DDoS koruma parametrelerini, Zero Trust erişim kurallarını, TLS sertifikalarını ve canlı güvenlik olaylarını programatik olarak yönetmenizi sağlayan yüksek performanslı RESTful servisidir.

Base URL

https://shield.nexren.info/api/v1

Format

application/json; charset=utf-8

Kimlik Doğrulama (Authentication)

API istekleri Authorization: Bearer nx_live_... veya X-API-Key: nx_live_... başlığı ile iletilir.

HTTP Authorization Header

curl -H "Authorization: Bearer nx_live_9a4f2bc8d7104b2a9e3e..." \
     https://shield.nexren.info/api/v1/sites

Rate Limits & Hata Formatı

Token başına varsayılan sınır 120 istek/dakikadır.

X-RateLimit-Limit: 120 X-RateLimit-Remaining: 118 X-RateLimit-Reset: 1725142800

GET /api/v1/sites Scope: sites:read

Kayıtlı Siteleri Listele

Hesabınıza kayıtlı tüm siteleri, koruma modlarını ve SSL/DNS durumlarını listeler.

curl -s -X GET "https://shield.nexren.info/api/v1/sites" \
     -H "Authorization: Bearer $NEXREN_API_KEY"

const res = await fetch("https://shield.nexren.info/api/v1/sites", {
  headers: { "Authorization": `Bearer ${process.env.NEXREN_API_KEY}` }
});
const data = await res.json();
console.log(data);

import os, requests
res = requests.get(
    "https://shield.nexren.info/api/v1/sites",
    headers={"Authorization": f"Bearer {os.getenv('NEXREN_API_KEY')}"}
)
print(res.json())

req, _ := http.NewRequest("GET", "https://shield.nexren.info/api/v1/sites", nil)
req.Header.Set("Authorization", "Bearer " + os.Getenv("NEXREN_API_KEY"))
resp, _ := http.DefaultClient.Do(req)

Canlı Konsol (Try It Out)

POST /api/v1/sites Scope: sites:write

Yeni Site Ekle

Yeni bir alan adı kaydeder, CNAME hedefini ve Let's Encrypt SSL hazırlıklarını oluşturur.

Alan	Tür	Zorunlu	Açıklama
domain	string	Evet	Korunacak alan adı (örn. `api.example.com`)
originUrl	string	Evet	Gerçek sunucu hedefi (örn. `https://198.51.100.42:443`)
mode	string	Hayır	`Balanced` (varsayılan), `Monitor`, `Under Attack`, `Off`

curl -s -X POST "https://shield.nexren.info/api/v1/sites" \
     -H "Authorization: Bearer $NEXREN_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "domain": "api.example.com",
       "originUrl": "https://198.51.100.20:443",
       "mode": "Balanced"
     }'

GET /api/v1/sites/{id} Scope: sites:read

Site Detayları

Belirtilen sitenin aktif durumunu, DNS doğrulamalarını ve SSL sertifikasını döndürür.

cURL Örneği

curl -s -X GET "https://shield.nexren.info/api/v1/sites/site_c16d7b058fe4" \
     -H "Authorization: Bearer $NEXREN_API_KEY"

POST /api/v1/sites/{id}/purge-cache Scope: sites:write

Edge Önbelleği Temizle

Edge sunucularında tutulan statik ve dinamik önbellek içeriğini anında geçersiz kılar.

cURL

curl -s -X POST "https://shield.nexren.info/api/v1/sites/site_c16d7b058fe4/purge-cache" \
     -H "Authorization: Bearer $NEXREN_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"all": true}'

POST /api/v1/sites/{id}/origin/test-lock Scope: sites:read

Origin Lock Canlı Doğrulama

Hedef sunucunuzun gizli kilit başlığını (Origin Lock Header) döndürüp döndürmediğini canlı olarak test eder.

cURL

curl -s -X POST "https://shield.nexren.info/api/v1/sites/site_c16d7b058fe4/origin/test-lock" \
     -H "Authorization: Bearer $NEXREN_API_KEY"

POST /api/v1/sites/{id}/ssl/issue Scope: sites:write

Let's Encrypt Sertifikası Üret

Alan adı için HTTP-01 ACME challenge sürecini tetikler ve Let's Encrypt üretim sertifikası temin eder.

cURL

curl -s -X POST "https://shield.nexren.info/api/v1/sites/site_c16d7b058fe4/ssl/issue" \
     -H "Authorization: Bearer $NEXREN_API_KEY"

PATCH /api/v1/sites/{id}/policy Scope: policies:write

Güvenlik Politikasını Güncelle

WAF, Bot Koruması, Rate Limit ve IP Beyaz/Kara listelerini anında günceller.

cURL

curl -s -X PATCH "https://shield.nexren.info/api/v1/sites/site_c16d7b058fe4/policy" \
     -H "Authorization: Bearer $NEXREN_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "mode": "Balanced",
       "wafEnabled": true,
       "botProtectionEnabled": true,
       "ipWhitelist": ["198.51.100.5", "203.0.113.0/24"]
     }'

POST /api/v1/tokens Scope: tokens:write

Yeni API Token Üret

Programatik olarak yeni bir API anahtarı üretir. Üretilen rawToken yalnızca bir kez iletilir.

cURL

curl -s -X POST "https://shield.nexren.info/api/v1/tokens" \
     -H "Authorization: Bearer $NEXREN_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "name": "CI/CD Pipeline Key",
       "scopes": ["sites:read", "sites:write", "analytics:read"],
       "expiresInDays": 90
     }'