API Anahtarları (Çok Yakında)
Çok yakında — herkese açık GoVista API'si henüz kullanıma sunulmadı. Aşağıdaki uç noktalar ön izlemedir ve lansmandan önce değişebilir. Erken erişim için hesap yöneticinizle iletişime geçin.
API Anahtarları
GoVista'yı mevcut sistemleriniz, özel uygulamalarınız veya üçüncü taraf araçlarla entegre etmek için API anahtarları oluşturun.
API Anahtarı Oluşturma
1. Ayarlar > API > API Anahtarları bölümüne gidin 2. API Anahtarı Oluştur butonuna tıklayın 3. Açıklayıcı bir ad girin (ör. "POS Entegrasyonu", "Web Sitesi CMS") 4. Kapsamı seçin:
- Okuma — Yalnızca veri okuyabilir (cihazlar, playlistler, analitik)
- Yazma — Veri okuyabilir ve değiştirebilir (içerik yükleme, playlist oluşturma)
- Yönetici — Tam erişim (kullanıcı yönetimi dahil tüm işlemler)
5. Oluştur butonuna tıklayın 6. Anahtarı hemen kopyalayın — tekrar gösterilmeyecektir
API Anahtarı Kapsamları
| Kapsam | Veri Okuma | Veri Yazma | Veri Silme | Kullanıcı Yönetimi | |--------|-----------|-----------|-----------|--------------------| | Okuma | Evet | Hayır | Hayır | Hayır | | Yazma | Evet | Evet | Hayır | Hayır | | Yönetici | Evet | Evet | Evet | Evet |
API Anahtarlarını Kullanma
API anahtarınızı istek başlığına ekleyin:
`` Authorization: Bearer API_ANAHTARINIZ ``
Veya sorgu parametresi olarak:
`` https://api.govista.app/v1/devices?api_key=API_ANAHTARINIZ ``
Gerekli minimum kapsamı kullanın. Entegrasyonunuz yalnızca cihaz durumunu okumaya ihtiyaç duyuyorsa, Okuma anahtarı kullanın. Bu, anahtarın ele geçirilmesi durumunda etkiyi sınırlar.
Anahtar Yönetimi
- Anahtar döndürme — Yeni bir anahtar oluşturun, entegrasyonunuzu güncelleyin, ardından eski anahtarı silin
- Anahtar silme — Erişimi anında iptal eder
- Kullanım görüntüleme — Her anahtarın en son ne zaman kullanıldığını görün
- Birden fazla anahtar — Farklı entegrasyonlar için ayrı anahtarlar oluşturun
Hız Limitleri
API anahtarları hız limitlerine tabidir:
- Okuma — Dakikada 100 istek
- Yazma — Dakikada 30 istek
- Yönetici — Dakikada 30 istek
Hız limitlerini aşmak 429 durum kodu döndürür.
Güvenlik En İyi Uygulamaları
- API anahtarlarını asla genel depolarda paylaşmayın
- Anahtarları saklamak için ortam değişkenlerini kullanın
- Anahtarları her 90 günde bir döndürün
- Artık kullanılmayan anahtarları silin
- Beklenmeyen aktivite için anahtar kullanımını izleyin
API anahtarlarına şifreler gibi davranın. API anahtarınıza sahip herkes, anahtarın kapsamı tarafından verilen izinlerle GoVista hesabınıza erişebilir. Bir anahtar ele geçirilirse derhal silin.