API Anahtarları

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 ``

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