QRMENU AI ve API Kurulum Rehberi
Bu doküman, sistemde kullanılan veya kullanılabilecek API anahtarlarının nasıl yönetileceğini açıklar.
1. OpenAI
Kullanım Alanları
- otomatik çeviri
- ürün açıklaması üretimi
- besin notu veya içerik iyileştirme
- admin destek araçları
Gerekli Bilgiler
- OpenAI hesabı
- proje
- API key
- yeterli bakiye veya billing
Resmî Başlangıç Bağlantıları
- API anahtarları:
https://platform.openai.com/api-keys - projeler:
https://platform.openai.com/ - yardım merkezi:
https://help.openai.com/
Temel Kurulum Adımları
- OpenAI hesabına giriş yap.
- Bir proje oluştur veya mevcut projeyi seç.
- API key üret.
- Billing ve kullanım limitlerini kontrol et.
- Anahtarı QRMENU ayarlarına gir.
- Test isteği ile doğrula.
Not
OpenAI arayüzü zaman içinde değişebilir. Bu yüzden son adımlar için her zaman resmî panel ve yardım merkezi kontrol edilmelidir.
2. Görsel API Sağlayıcıları
Pexels
- kullanım: stok görsel arama
- site:
https://www.pexels.com/api/
Pixabay
- kullanım: stok görsel arama
- site:
https://pixabay.com/api/docs/
Unsplash
- kullanım: stok görsel arama
- site:
https://unsplash.com/developers
Bu anahtarlar admin ayarlarına girilir. Arama sırasında bir sağlayıcı hata verirse fallback çalıştırılabilir.
3. Döviz, Zaman ve Yardımcı Servisler
Sisteme bağlı olarak şu servisler eklenebilir:
- kur servisleri
- çeviri servisleri
- bildirim servisleri
Bu yüzden ayar ekranında her servis için şu alanlar önerilir:
- key
- secret
- endpoint
- timeout
- test butonu
4. Güvenlik Kuralları
- API key'ler public repoya konmaz
- ekran görüntülerinde anahtar gizlenir
- mümkünse
.envveya sunucu config kullanılır - kullanım limitleri takip edilir
- başarısız çağrılar loglanır
5. Bilgi Bankası İçeriği İçin Öneri
Her API dokümanı için şu başlıklar tutulmalıdır:
- ne işe yarar
- nereden alınır
- hangi plana ihtiyaç duyar
- nasıl eklenir
- nasıl test edilir
- tipik hatalar
- örnek ekran görüntüsü
6. Destek Notu
OpenAI ve diğer sağlayıcıların panel akışları değişebileceği için müşteri teslim dokümanında resmî bağlantı verilmesi gerekir.