Geliştirici

Flowera arayüzünde yapabildiğiniz her şeyi koddan da yapabilirsiniz — bir akışı çalıştırmak, gömmek, paylaşmak ve programatik olarak akış kurmak.

Flowera'yı programatik kullanma yolları

Şunu istiyorsanız…	Bunu kullanın
Arka ucunuzdan bir akış çalıştırıp yanıtı almak	Prediction API
Web sitenize sohbet widget'ı koymak	Chatbot'u gömme
Birine çalışan bir botun linkini göndermek	Link paylaşma
Bir sistemin akışa olay göndermesini sağlamak	Özel webhook
Koddan ya da bir yapay zeka asistanıyla akış oluşturup düzenlemek	MCP ile oluşturma
Bir bilgi tabanını senkron tutmak	Doküman deposu API'si

Önemli olan ayrım yöndür. Prediction API sizin Flowera'yı çağırmanızdır; özel webhook ise Flowera'nın çağrılmasıdır. Hangisini istediğiniz, etkileşimi kimin başlattığına bağlıdır.

Kimlik doğrulama

Tüm programatik erişim, Authorization başlığında bir çalışma alanı API anahtarı kullanır:

Authorization: Bearer <api_anahtariniz>

Bir anahtar çalışma alanının tamamına değil, tek bir akışa bağlıdır. Anahtarı bir akışa eklersiniz ve o akışı yalnızca o anahtar çağırabilir — aynı çalışma alanındaki başka bir akışın anahtarı 401 alır. Entegrasyon başına bir anahtar oluşturun; biri sızdığında tek bir şeyi iptal edersiniz.

Anahtar eklenmemiş bir akışı, kimliğini bilen herkes çağırabilir

Anahtar eklemek isteğe bağlıdır. Siz ekleyene kadar o akışın tahmin uç noktası kimlik doğrulaması olmayan istekleri kabul eder — geliştirme sırasında pratik, üretimde kredinizi harcamak için açık bir davetiye.

Bir adresi engelleten şey var olmayan akış kimliklerini çağırmaktır: 15 dakika içinde üç 404, adresi bir saat engeller. Hatalı anahtar 401 döner ve bu sayaca dahil olmaz; yine de döngüde denemenin bir anlamı yoktur.

Bearer kimlik doğrulamanın iki istisnası:

• Gömme widget'ı anahtar değil bir akış kimliği taşır. Sayfanızı görebilen herkes botla konuşabilir — bkz. Gömme.
• Paylaşılan bir link, Make Public açıkken hiç kimlik doğrulama istemez.

İkisi de bilinçlidir ve ikisi de arkalarındaki akışın herkese açık bir arayüz olduğu anlamına gelir. Talimatına yayımlamayacağınız hiçbir şeyi koymayın.

Maliyetler geçerlidir

Her programatik çalıştırma, arayüzden yapılan bir çalıştırma gibi kredi harcar. Bozuk bir uç noktaya karşı bir yeniden deneme döngüsü gerçek para harcar — yeni bir şey bağladıktan sonra Kullanım Paneli'ne bakın.

Başka yerde anlatılanlar

• MCP server — akışları programatik olarak oluşturma ve yönetme MCP ile oluşturma sayfasında anlatılıyor.
• Custom webhook'lar — kendi sistemlerinizden olay almak Custom webhook ve Custom webhook kanalı sayfalarında anlatılıyor.

Bu bölümde

• Prediction API — akışı HTTP üzerinden çalıştırma
• Chatbot'u gömme — web sitesi widget'ı
• Link paylaşma — tek bir akış için barındırılan sayfa