# 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ı

1. OpenAI hesabına giriş yap.
2. Bir proje oluştur veya mevcut projeyi seç.
3. API key üret.
4. Billing ve kullanım limitlerini kontrol et.
5. Anahtarı QRMENU ayarlarına gir.
6. 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 `.env` veya 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.