Skip to main content
Access token 15 gün geçerlidir. Süresi dolduğunda, token değişiminde aldığınız refresh_token’ı kullanarak yeni bir çift (access + refresh) alabilirsiniz. Refresh token’lar 30 gün geçerlidir.

​
Ne zaman yenilemeli?

  • Bir API çağrısı 401 Unauthorized ile dönerse token’ı yenileyip isteği bir kez tekrarlayın.
  • Proaktif yenileme için expires_in değerini saklayın ve süre dolmadan kısa süre önce (ör. 1 saat önce) yenileyin.
  • refresh_token 30 gün geçerlidir; bu süre dolduktan sonra kullanıcıyı yeniden yetkilendirmeniz gerekir.

​
İstek

curl --request POST \
  --url https://dev.flextell.ai/oauth/token \
  --header "Content-Type: application/x-www-form-urlencoded" \
  --data "grant_type=refresh_token" \
  --data "refresh_token=ESKI_REFRESH_TOKEN" \
  --data "client_id=SIZIN_CLIENT_ID" \
  --data "client_secret=SIZIN_CLIENT_SECRET" \
  --data "scope=customers:read appointments:read"
​
grant_type
string
required
Her zaman refresh_token.
​
refresh_token
string
required
Daha önce aldığınız geçerli refresh token.
​
client_id
string
required
OAuth uygulamanızın client_id değeri.
​
client_secret
string
required
OAuth uygulamanızın client_secret değeri. PKCE ile oluşturulmuş public client’lar bu alanı göndermez.
​
scope
string
Opsiyonel. Orijinal yetkilendirmedeki scope’ların bir alt kümesi olabilir. Gönderilmezse orijinal scope’lar korunur. Yeni scope talep etmek için kullanıcıyı tekrar yetkilendirme akışına sokmanız gerekir.

​
Yanıt

{
  "token_type": "Bearer",
  "expires_in": 1296000,
  "access_token": "eyJ0eXAi...",
  "refresh_token": "def50200yeni..."
}
Yeni refresh_token’ı saklayın. Flextell her yenileme sonrasında eski refresh token’ı iptal edip yenisini verir (refresh token rotation). Eski token artık çalışmaz.

​
Otomatik yenileme kalıbı

HTTP istemcinizi, 401 yanıtında token’ı yenileyip isteği bir kez tekrarlayacak şekilde sarmalamak iyi bir örüntüdür: 
async function flextellFetch(url, options = {}, retry = true) {
  const res = await fetch(url, {
    ...options,
    headers: {
      ...options.headers,
      Authorization: `Bearer ${tokens.access_token}`,
    },
  });

  if (res.status === 401 && retry) {
    await refreshTokens();
    return flextellFetch(url, options, false); // bir kez tekrar dene
  }

  return res;
}

​
Hata yanıtları

HTTPerrorSebep
400invalid_grantRefresh token geçersiz, süresi dolmuş veya iptal edilmiş. Kullanıcıyı yeniden yetkilendirmelisiniz.
401invalid_clientclient_id/client_secret hatalı.
400invalid_scopeOrijinal yetkilendirmede olmayan bir scope talep ettiniz.

​
Güvenlik notları

  • Refresh token’ları server-side saklayın; tarayıcı localStorage’ına yazmayın.
  • Mümkünse kullanıcı başına şifrelenmiş saklama kullanın.
  • Bir refresh token yenileme sırasında yenisi dönerse eskiyi kullanmaya devam etmeyin; eski token muhtemelen iptal edilmiştir.
  • Kullanıcı panelden uygulamanıza verdiği yetkiyi kaldırırsa tüm token’lar anında geçersiz olur.