API Referansi — CloudPanel

🔐

Kimlik Dogrulama

Tum API isteklerinde Authorization header gereklidir. API key'inizi Paneldeki API Keys bolumunden olusturun.

                Authorization: Bearer cpk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
            

📖 Giris

CloudPanel REST API'si, Cloudflare yonetiminizi programatik olarak yapmanizi saglar. Tum istekler JSON formatinda yanit verir.

Base URL

https://security.netguc.com/api/v1

Surum

Format

application/json

GET /api/v1/zones 🔐 Auth Gerekli

Kullanicinin erisim sahibi oldugu tum Cloudflare zone'larini listeler.

Ornek Istek:

curl -X GET \
  https://security.netguc.com/api/v1/zones \
  -H "Authorization: Bearer cpk_xxx..."

Ornek Yanit:

{
  "success": true,
  "result": [
    {
      "id": "abc123",
      "name": "ornek.com",
      "status": "active",
      "plan": "free"
    }
  ]
}

GET /api/v1/zones/{zone_id}/dns 🔐 Auth Gerekli

Belirtilen zone'a ait tum DNS kayitlarini listeler.

Parametreler:

Parametre	Tur	Aciklama
`zone_id` *	string	Zone ID (URL parametresi)
`type`	string	Filtre: A, CNAME, MX, TXT vb.

Ornek Istek:

curl -X GET \
  https://security.netguc.com/api/v1/zones/abc123/dns?type=A \
  -H "Authorization: Bearer cpk_xxx..."

POST /api/v1/zones/{zone_id}/dns 🔐 Auth Gerekli

Belirtilen zone'a yeni bir DNS kaydi ekler. "dns" izni gerektirir.

Body Parametreleri:

Alan	Tur	Zorunlu	Aciklama
`type`	string	Evet	A, AAAA, CNAME, MX, TXT vb.
`name`	string	Evet	@ veya subdomain
`content`	string	Evet	IP adresi veya deger
`ttl`	integer	Hayir	1 = Auto (varsayilan)
`proxied`	boolean	Hayir	Cloudflare proxy (varsayilan: false)

Ornek Istek:

curl -X POST \
  https://security.netguc.com/api/v1/zones/abc123/dns \
  -H "Authorization: Bearer cpk_xxx..." \
  -H "Content-Type: application/json" \
  -d '{"type":"A","name":"www","content":"1.2.3.4","proxied":true}'

POST /api/v1/zones/{zone_id}/purge 🔐 Auth Gerekli

Zone'un cache'ini tamamen veya belirli URL'ler icin temizler. "cache" izni gerektirir.

Body Parametreleri:

Alan	Tur	Aciklama
`purge_everything`	boolean	true ise tum cache temizlenir
`files`	array	Temizlenecek URL listesi

Tum Cache Temizle:

curl -X POST \
  https://security.netguc.com/api/v1/zones/abc123/purge \
  -H "Authorization: Bearer cpk_xxx..." \
  -d '{"purge_everything":true}'

GET /api/v1/zones/{zone_id}/ssl 🔐 Auth Gerekli

Zone'a ait SSL/TLS ayarlari ve sertifika bilgilerini getirir.

Ornek Istek:

curl -X GET \
  https://security.netguc.com/api/v1/zones/abc123/ssl \
  -H "Authorization: Bearer cpk_xxx..."

❌ Hata Kodlari

Kod	Anlami	Cozum
400	Gecersiz Istek	Body parametrelerini kontrol edin
401	Yetkisiz	Authorization header ekleyin veya API key'i kontrol edin
403	Yasak	API key'in gerekli izne sahip oldugundan emin olun
404	Bulunamadi	Zone ID veya kayit ID'yi kontrol edin
429	Rate Limit Asimi	Istek hizinizi azaltin
500	Sunucu Hatasi	Destek ekibiyle iletisime gecin

Hata Yanit Formati:

{
  "success": false,
  "error": "Unauthorized",
  "message": "Gecersiz API key"
}