← Kaynaklara dön
Rehber
API Referansı
AnchorSpot, AnchorNAC ve AnchorLog platformlarının programatik erişim için sunduğu REST API referansı.
Kimlik Doğrulama
API erişimi JWT tabanlı bearer token ile sağlanır. Token, yönetim panelinden oluşturulan API anahtarı ile /auth/token uç noktasından alınır.
- POST /auth/token — API anahtarı ile JWT token alma
- Bearer token tüm isteklerde Authorization başlığında gönderilir
- Token süresi yapılandırılabilir (varsayılan 1 saat)
- Refresh token desteği ile kesintisiz oturum yönetimi
Temel Uç Noktalar
Her ürün modülü kendi API ad alanı altında uç noktalar sunar. Yanıtlar JSON formatındadır ve standart HTTP durum kodları kullanılır.
- GET /api/v1/spot/sessions — aktif misafir oturumlarını listeleme
- GET /api/v1/nac/devices — ağdaki cihaz envanterini sorgulama
- GET /api/v1/log/entries — log kayıtlarını filtreleme ve arama
- POST /api/v1/nac/policies — yeni politika oluşturma
- GET /api/v1/log/chain/verify — hash zinciri doğrulama
Sayfalama ve Filtreleme
Liste uç noktaları imleç tabanlı sayfalama kullanır. Zaman aralığı, cihaz türü ve durum gibi filtreleme parametreleri desteklenir.
- cursor ve limit parametreleri ile sayfalama
- since ve until parametreleri ile zaman aralığı filtresi
- sort parametresi ile sıralama (created_at, updated_at)
- fields parametresi ile yanıt alanlarını sınırlama
Webhook Entegrasyonu
Belirli olaylarda harici sistemlere otomatik bildirim göndermek için webhook'lar yapılandırılabilir. Her webhook isteği HMAC-SHA256 imzası ile doğrulanabilir.
- Yeni cihaz bağlantısı, politika ihlali ve log uyarısı olayları
- HMAC-SHA256 ile istek imzası doğrulaması
- Başarısız gönderimler için otomatik yeniden deneme
- Webhook geçmişi ve hata ayıklama logları