Skip to main content
Flextell API’ye bir istek atmadan önce, Flextell panelinde bir OAuth uygulaması oluşturmanız gerekir. Bu uygulama sizin entegrasyonunuzu temsil eder — bir client_id, bir client_secret, onaylı redirect_uri’ler ve talep ettiğiniz scope listesi tutar.

​
Adımlar

1

Panele giriş yapın

https://app.flextell.ai (veya sandbox için https://dev.flextell.ai) üzerinden giriş yapın.
2

Uygulamalar sayfasını açın

Sol menüden Bağlantılar → Uygulamalar adımını takip edin.
Bu sayfada yalnızca sizin oluşturduğunuz uygulamalar listelenir.
3

Yeni uygulama ekleyin

Sağ üstteki Yeni butonuna tıklayın. Aşağıdaki alanları doldurun:
​
Uygulama Adı
string
required
Entegrasyonunuzu tanımlayan açıklayıcı bir isim. Kullanıcılara yetkilendirme ekranında bu isim gösterilir.
​
Yönlendirme URI'leri
string[]
required
OAuth akışında Flextell’in code’u geri göndereceği URL’ler. En az bir tane olmalıdır. Yerel geliştirme için http://localhost:3000/callback geçerlidir; production için tam HTTPS URL kullanın.
​
Çıkış Sonrası Yönlendirme URI'leri
string[]
OpenID Connect end_session_endpoint ile logout yapıldığında kullanıcının yönlendirileceği URL’ler. Opsiyoneldir.
​
İzinler (scopes)
string[]
required
Uygulamanızın talep edeceği izinler. En az bir scope seçmelisiniz. Tam liste: Scopes.
4

client_secret'ı güvenli yere kaydedin

Uygulama oluşturulduğunda panel size client_id ve client_secret değerlerini gösterir.
client_secret yalnızca bir kez gösterilir. Kaybederseniz uygulamayı silip yeniden oluşturmanız gerekir. Secret’ı parola yöneticisi, ortam değişkeni veya vault gibi güvenli bir ortamda saklayın. Kaynak kodunuza veya versiyon kontrolüne asla commit etmeyin.

​
Redirect URI kuralları

  • HTTPS kullanın. Yerel geliştirme için http://localhost ve http://127.0.0.1 istisnadır.
  • Tam eşleşme zorunludur. Yetkilendirme isteğinde gönderilen redirect_uri, kayıtlı URI’lerden biriyle birebir eşleşmelidir (path, query string, trailing slash dahil).
  • Her uygulama için birden fazla URI tanımlayabilirsiniz; örneğin prod ve staging için.
  • Fragment (#...) içeren URI’ler kabul edilmez.

​
Birden fazla ortam için ayrı uygulamalar

Sandbox ve production ortamları birbirinden tamamen izoledir. Sandbox’ta oluşturduğunuz client_id/client_secret production’da çalışmaz. Her iki ortamda da ayrı uygulamalar açmanızı öneririz. 
# .env.local
FLEXTELL_BASE_URL=https://dev.flextell.ai
FLEXTELL_CLIENT_ID=sandbox_client_id
FLEXTELL_CLIENT_SECRET=sandbox_client_secret

# .env.production
FLEXTELL_BASE_URL=https://app.flextell.ai
FLEXTELL_CLIENT_ID=prod_client_id
FLEXTELL_CLIENT_SECRET=prod_client_secret

​
Scope’ları düzenleme

Uygulamanızı oluşturduktan sonra talep ettiğiniz scope listesini değiştirmek için yeni bir uygulama oluşturmalısınız. Mevcut bir uygulamanın scope’larının genişletilmesi güvenlik nedeniyle engellenmiştir — kullanıcılar yetki verirken sadece o anki listeyi onaylar.

​
Sonraki adım

Uygulamanızı oluşturduğunuza göre, Authorization Code akışı ile ilk token’ınızı alabilirsiniz.