REST API nedir; TR7'yi programatik olarak yönetmek için ne sunar?

Kısa cevap

REST API, HTTP üzerinden kaynak tabanlı programatik erişim sağlayan arayüz tarzıdır (Fielding, REST): her nesne bir kaynak, üzerindeki işlemler listeleme, görüntüleme, ekleme, güncelleme ve silmedir. TR7 yönetim paneli cihazdaki REST API'nin üzerinde çalışır; endpoint'ler API7 Docs'ta belgelenir (platform bileşenleri). Arayüzde bu API'nin doğrudan karşılığı WEB-CLI'daki API Commands dalıdır: dal panelin REST arayüzünden türetilir; her kaynak komut ağacında bir düğüm, her işlem bir aksiyon (list, show, add, update, delete, destekleyen kaynaklarda update-many) olur ve alan adları arayüzdekiyle aynı tanımlardan gelir. Yetki denetimi arayüzdekiyle aynıdır: okuma komutları ilgili alanı görme, yazma komutları değiştirme yetkisi ister.

TR7'de Nerede Kullanılır

Nerede	Alan / etiket	Ne için
Panelin sağ alt köşesi → WEB-CLI	API Commands dalı (lb, waf, ags, gtm, network, settings…)	Kaynakları REST API üzerinden komutla yönetme
Aynı dal	Aksiyonlar: list, show, add, update, delete; destekleyen kaynaklarda update-many	Her kaynakta aynı işlem kümesi
Settings → User Management → Device Users → kullanıcı	Access CLI over WEB, Access CLI over SSH	Kullanıcıya WEB-CLI ve SSH üzerinden CLI erişimi verme
Settings → System Logs → User Logs	User Logs	WEB-CLI ve CLI üzerinden yapılan değişikliklerin de kaydı; bu kayıtlarda User-agent kolonunun sonunda kaynak (@…) yazar
docs.tr7.com	API7 Docs	REST API endpoint'lerinin belgesi

• WEB-CLI'ın dalları ve yetki eşlemesi: WEB-CLI nedir; hangi komut dallarını sunar? · Komut yetkileri: Erişim ve yetkiler
• Load Balancer'ın komutla yönetimi: Load Balancer yapılandırmasını CLI veya API ile yönetebilir miyim?

Sık Karıştırılan Noktalar

• "Arayüzdeki her işlemin komut karşılığı vardır." Bazı işlemler yalnızca arayüzdedir; örneğin WAF'ta Signature & Rule Library ve Allow / Teach (WAF'ı WEB-CLI ile yönetebilir miyim; hangi işlemler WEB-CLI'da yok?).
• "API ve CLI komutları yetkiyi atlar." Okuma komutları ilgili alanı görme, yazma komutları değiştirme yetkisi ister; yetki arayüzdekiyle aynıdır.
• "update komutu kaydın bütün alanlarını yeniden yazar." update mevcut kaydı okuyup yalnızca verilen alanları değiştirir; diğer alanlar korunur.

Dokümantasyonda nasıl yapılır

• API Commands · API Commands nedir
• API Commands · Aksiyonlar
• Products & Licensing · Platform bileşenleri
• API7 Docs

İlgili sorular

• Load Balancer yapılandırmasını CLI veya API ile yönetebilir miyim?
• WAF'ı WEB-CLI ile yönetebilir miyim; hangi işlemler WEB-CLI'da yok?
• WEB-CLI nedir; hangi komut dallarını sunar?