Felo API PlatformFelo API Platform

Felo Oluşturma Durumu

Sağlayıcı: Felo · Platform bakiyesinden ödenir

Kimlik doğrulama ve kurulumFaturalandırma ve hatalarTam iş akışı kılavuzu

Bir sunumu eşzamansız olarak oluşturun, ardından bir PPTX dosyası dışa aktarın. Oluşturma ve dışa aktarma adımlarını ayrı tutun: oluşturulmuş bir görev henüz bitmiş bir dosya değildir.

Tüm örnekler genel bakış içindeki FELO_API_KEY’i kullanır. Çağrılar Felo Pro kredilerini değil, platform bakiyesini kullanır. Yanıt örnekleri açıklayıcıdır; canlı içerik ve isteğe bağlı alanlar değişebilir.

Görevi oluştururken döndürülen tanımlayıcıları kullanın. TASK_ID değerini task_id olarak ve PPT_ID değerini ppt_business_id olarak ayarlayın; {business_id} da ppt_business_id anlamına gelir.

TASK_ID="YOUR_TASK_ID"
PPT_ID="YOUR_PPT_BUSINESS_ID"

2. Oluşturma durumunu sorgulayın

GET /api/v1/data/tasks/{task_id}/status

curl -sS --request GET "https://openapi.felo.ai/api/v1/data/tasks/$TASK_ID/status" \
  -H "Authorization: Bearer $FELO_API_KEY"

Yanıtın kökünde, örneğin RUNNING veya COMPLETED gibi bir status dizesi vardır. Sabitlenmiş bir aralıkla (örneğin 2–5 saniye) ve bir son tarih ile sorgulayın. Başarı varsaymadan, tamamlandıktan sonra sonuçlara geçin; başarısızlığı ve beklenmeyen durumları işleyin. Bir sorgulama son tarihi görevi iptal etmez.

{"status":"COMPLETED"}

Yaşam süresi, sahiplik ve faturalandırma

  • Sunumların süresi oluşturulmadan yedi gün sonra dolar. Sorgular ve dışa aktarmalar bu süreyi uzatmaz. Sunum expires_at değeri ile imzalı indirme URL’sinin expires_at değeri farklı ömürleri tanımlar.
  • Yalnızca oluşturan API hesabı kendi görevlerine ve sunumlarına erişebilir. Eksik veya erişilemeyen bir kaynak 404 döndürebilir; süresi dolmuş veya silinmiş bir kaynak 410, ya da temizlemeden sonra 404 döndürebilir.
  • Oluşturma, oluşturulan sayfa başına (ppt.generate) faturalandırılır. Sayfa fiyatlandırmasında, oluşturma on sayfanın fiyatını ayırır, ardından gerçek başarılı çıktıyla kesinleşir ve kullanılmayan rezervasyonu serbest bırakır. İstem daha az sayfa istese bile hesabınızın bu rezervasyon için yeterli kullanılabilir bakiyesi olmalıdır.
  • Dışa aktarma ayrı bir istek fiyatına sahiptir (ppt.export). Durum sorguları, sonuç sorguları, dışa aktarma-durumu sorguları ve silme yeni bir ücret oluşturmaz.
  • Zaman aşımından sonra başka bir sunum oluşturmak yerine kaydedilmiş görevi sorgulayın. Faturalandırma ve Hatalar bölümüne bakın.

Yardım mı gerekiyor?