API Erişimi

Doküman depoları arayüzden olduğu kadar koddan da yönetilebilir. Değişen bir kaynakla — bir ürün kataloğu, bir yardım merkezi, gecelik bir dışa aktarım — depoyu aynı hizada tutmanın yolu budur.

Depoyu programatik yönetme

API'nin en kullanışlı işlemi upsert'tür: var olan bir depoya bir dosya gönderirsiniz; tek çağrıda yüklenir, bölünür, gömülür ve indekslenir — hem de arayüzde kurulmuş yapılandırmayı yeniden kullanarak.

Önemli ayrıntı budur. Yükleyiciyi, ayırıcıyı, embedding modelini ve vector store'u bir kez elle yapılandırırsınız; sonra API gönderdiğiniz her dosya için tam olarak o kurulumu tekrarlar. Betiğinizin bunların hiçbirini bilmesi ya da yeniden bildirmesi gerekmez.

Kullanılabilir işlemler

İşlem	Ne yapar
Upsert	Deponun mevcut yapılandırmasını kullanarak bir dokümanı ekler veya değiştirir
Refresh	Depodaki her yükleyiciyi yeniden çalıştırır ve sonucu yeniden indeksler

API'nin tamamı bu ikisidir. Bir depoda arama yapmak API anahtarına açık değildir — sorgu alanı giriş yapılmış bir oturum gerektirir ve API anahtarıyla yapılan çağrı 401 döner. Bir depoda programatik arama için, içinde Bilgi Getirici node'u bulunan bir akışı Tahmin API'si üzerinden çağırın.

Refresh, yapılandırma değil kaynaklar değiştiğinde başvurulacak seçenektir: her yükleyiciyi yeniden getirir; böylece bir web sitesinden ya da bir S3 kovasından kurulmuş bir depo tek çağrıda güncellenebilir.

Kimlik doğrulama

İstekler Authorization başlığında bir çalışma alanı API anahtarıyla doğrulanır:

Authorization: Bearer <api_anahtariniz>

Anahtar çalışma alanını, dolayısıyla hangi depolara erişebileceğinizi belirler.

Bir yükleyici satırının Seçenekler → API'yi Görüntüle menüsünü açtığınızda Flowera o depoya özel hazır isteği, kimliği doldurulmuş hâlde ve Python, JavaScript ve cURL sürümleriyle gösterir.

Örnek istek

Var olan bir depoya dosya eklemek:

curl -X POST https://<flowera-alan-adiniz>/api/v1/document-store/upsert/<storeId> \
  -H "Authorization: Bearer <api_anahtariniz>" \
  -F "files=@./el-kitabi-2026.pdf" \
  -F "docId=<loaderId>" \
  -F "replaceExisting=true"

Alan	Ne yapar
files	Yüklenecek dosya
docId	Yapılandırması yeniden kullanılacak mevcut yükleyici
replaceExisting	true o yükleyicinin parçalarını değiştirir; false yanına ekler
loaderName	Yükleyici için isteğe bağlı etiket
splitter, embedding, vectorStore, recordManager	İsteğe bağlı geçersiz kılmalar — deponun ayarlarını korumak için yazmayın

Yeni bir sürümü olan bir doküman için istediğiniz replaceExisting=true'dur. false bırakırsanız her senkronizasyon aynı içeriğin bir kopyasını daha ekler; yinelenenler diğer sonuçları dışarı ittikçe getirme sessizce bozulur.

Depoyu senkron tutma

Değişen dokümanları yeniden yükleyen gecelik bir iş genellikle yeterlidir:

1. Depoyu bir kez elle kurun — yükleyici, ayırıcı, embeddings, vector store.
2. Depo kimliğini ve yükleyici kimliğini API'yi Görüntüle penceresinden not edin.
3. İşinizin değişen her dosyayı replaceExisting=true ile POST etmesini sağlayın.
4. Depoya önce bir Record Manager ekleyin (bkz. Vector store); böylece tekrarlanan upsert'ler çoğaltmak yerine günceller.

Her upsert'ün gönderdiğini yeniden gömdüğünü ve bunun biraz para tuttuğunu unutmayın. Her şeyi değil, değişeni senkronlayın.

İlgili

• API Anahtarları — anahtarı oluşturma ve koruma
• Vector store — record manager ve yinelenen parçalar
• Prediction API — depo değil akış çağırmak