TR
Access token rehberi

Facebook API Access Token: User, Page, App ve System User Token'ları

Her token nasıl alınır, yaklaşık 60 güne nasıl uzatılır, debug_token ile nasıl kontrol edilir ve 190 hatası nasıl ele alınır; ayrıca bir SaaS uygulamasının token sürecini nasıl tamamen atlayabileceği.

Token kontrolü 200 OK
GETgraph.facebook.com/debug_token?input_token={USER_ACCESS_TOKEN}
applicationUygulamanız
is_validtrue
expires_at60 gün içindeuzun ömürlü user token
data_access_expires_at90 gün içindekullanıcı aktif oldukça yenilenir
scopespublic_profilepages_show_list
TOKEN Refresh token yok: kontrol edin, sonra yeniden giriş
Kısa yanıt

Facebook API access token, her Graph API çağrısının ihtiyaç duyduğu dizedir. User token'ı Facebook Login ile (testler için Graph API Explorer ile) alırsınız, sunucunuzda yaklaşık 60 gün geçerli uzun ömürlü bir token ile değiştirirsiniz, ardından Page token'ları için /me/accounts çağrısını yaparsınız. API anahtarı da refresh token da yoktur: token'ları debug_token ile izleyin ve 190 hatasını ele alın.

Çok sayıda müşteriye hizmet veren bir SaaS için ikinci bir model vardır: kullanıcılar Facebook hesaplarını Unipile üzerinden bağlar ve uygulamanız hiçbir Meta token'ı tutmaz.

Unipile ile

Alınacak, uzatılacak veya hata ayıklanacak bir Meta token'ı yok

  1. 1

    Hesabı bağlayın

    Kullanıcınız Facebook hesabını veya Sayfasını Hosted Auth üzerinden bir kez bağlar. Meta uygulaması yok, App Review yok.

  2. 2

    API anahtarınızla çağırın

    Kullanıcının account_id değeriyle birlikte X-API-KEY gönderin: GET /v2/{ACCOUNT_ID}/chats.

  3. 3

    Tek bir durumu izleyin

    products_connection_status alanını kontrol edin; gerekirse kullanıcı Hosted Auth üzerinden yeniden bağlanır.

Tanım

Facebook API Access Token Nedir?

Meta, access token'ı "bir kullanıcıyı, uygulamayı veya Facebook Sayfasını tanımlayan opak bir dize" olarak tanımlar. Her Graph API isteği bir token taşır ve token'ın türü kimin adına işlem yaptığınızı belirler.

TokenKimin adınaNasıl alınırSüre ve kullanım
UserGiriş yapmış bir kişiFacebook Login veya Graph API Explorer1 ile 2 saat ya da yaklaşık 60 gün
PageBir Facebook SayfasıBir yöneticinin user token'ı ile /me/accountsBağlı olduğu user token'ı izler
AppMeta uygulamanızclient_credentials çağrısı veya {APP_ID}|{APP_SECRET}Yalnızca sunucudan sunucuya çağrılar
System userİşletmenizBusiness SettingsSüresiz veya 60 gün
Clientİstemci kodundaki uygulamanızApp DashboardGizli değildir
User token
Kimin adınaGiriş yapmış bir kişi
Nasıl alınırFacebook Login veya Graph API Explorer
Süre ve kullanım1 ile 2 saat ya da yaklaşık 60 gün
Page token
Kimin adınaBir Facebook Sayfası
Nasıl alınırBir yöneticinin user token'ı ile /me/accounts
Süre ve kullanımBağlı olduğu user token'ı izler
App token
Kimin adınaMeta uygulamanız
Nasıl alınırclient_credentials çağrısı veya {APP_ID}|{APP_SECRET}
Süre ve kullanımYalnızca sunucudan sunucuya çağrılar
System user token
Kimin adınaİşletmeniz
Nasıl alınırBusiness Settings
Süre ve kullanımSüresiz veya 60 gün
Client token
Kimin adınaİstemci kodundaki uygulamanız
Nasıl alınırApp Dashboard
Süre ve kullanımGizli değildir

Instagram'ın kendi akışı vardır: Instagram API token rehberimize bakın.

Kaynak: Meta'nın Access Tokens rehberi. Son doğrulama: 17 Kasım 2026.

Token alma

Facebook API Access Token Nasıl Alınır

Facebook API anahtarı diye bir şey yoktur: her çağrı bir access token kullanır. Testler için Graph API Explorer'da kendi hesabınıza bir token oluşturun. Üretimde kullanıcılar Facebook Login ile (Sayfalarına ihtiyacınız varsa Facebook Login for Business ile) Meta uygulamanıza giriş yapar ve sunucunuz dönen kodu bir user access token ile değiştirir.

Test, 4 adımda

Graph API Explorer

  1. developers.facebook.com/tools/explorer adresini açın
  2. Meta uygulamanızı ve "User Token" seçeneğini seçin
  3. İhtiyacınız olan izinleri ekleyin
  4. Generate Access Token'a tıklayıp onaylayın
Üretim, 4 adımda

Meta uygulamanızda Facebook Login

  1. Bir Meta uygulaması oluşturun (App ID, App Secret)
  2. Kullanıcıları client_id, redirect_uri ve state ile /dialog/oauth adresine yönlendirin
  3. İzinleri verirler; siz bir code alırsınız
  4. Sunucunuz code ve App Secret ile /oauth/access_token çağrısını yapar

Yanıt access_token, token_type ve expires_in alanlarını içerir. Başka kişiler ancak App Review uygulamanıza Advanced Access verdikten sonra izin verebilir. Erişim sürecinin tamamı Facebook API genel bakışımızda, Sayfa tarafı ise Facebook Page API rehberimizde yer alıyor.

Kaynak: Meta'nın Manually Build a Login Flow rehberi (Graph API v27.0). Son doğrulama: 17 Kasım 2026.

Uzun ömürlü token'lar

Uzun Ömürlü Access Token Nasıl Alınır

Kısa ömürlü user token'ı grant_type=fb_exchange_token, App ID'niz ve App Secret'ınızla birlikte GET /oauth/access_token adresine gönderin. Yanıt, uzun ömürlü bir token ve onun expires_in değerini, yani yaklaşık 60 günü içerir. Meta bu konuda açıktır: "Bu çağrıyı istemciden değil, sunucunuzdan yapın."

  • Süresi dolmadan değiştirin. "Süresi dolmuş bir token ile uzun ömürlü token talep edemezsiniz": kısa token'ın süresi dolduğunda kullanıcının yeniden giriş yapması gerekir.
  • Son kullanma tarihini token'ın yanında bir tarih olarak saklayın.
  • Yalnızca test mi? Access Token Debugger'daki Extend Access Token düğmesi, kendi token'larınızdan biri için aynı işi yapar.

Kodda token yaşam döngüsü

1 ile 3 arasındaki sekmeler Meta'nın Graph API'sini kullanır; 4. sekme Unipile'dır ve Meta token'ı gerektirmez.

# Server side only: this call carries your App Secret
curl -G "https://graph.facebook.com/oauth/access_token" \
  -d "grant_type=fb_exchange_token" \
  -d "client_id={APP_ID}" \
  -d "client_secret={APP_SECRET}" \
  -d "fb_exchange_token={USER_ACCESS_TOKEN}"

# Response (abridged)
{ "access_token": "{LONG_LIVED_USER_TOKEN}", "expires_in": 5183944 }
# App access token, for server-to-server calls such as debug_token
curl -G "https://graph.facebook.com/oauth/access_token" \
  -d "client_id={APP_ID}" \
  -d "client_secret={APP_SECRET}" \
  -d "grant_type=client_credentials"

# Or pass it directly, without the call
access_token={APP_ID}|{APP_SECRET}
# Check any token with your app token
curl -G "https://graph.facebook.com/debug_token" \
  -d "input_token={LONG_LIVED_USER_TOKEN}" \
  -d "access_token={APP_ID}|{APP_SECRET}"

# Response (abridged)
{ "data": {
    "app_id": "{APP_ID}",
    "is_valid": true,
    "expires_at": 1800057600,
    "data_access_expires_at": 1802649600,
    "scopes": ["public_profile", "pages_show_list"]
} }
# No Meta token: your API key and the user's account_id
curl --request GET \
  --url "https://api.unipile.com/v2/{ACCOUNT_ID}/inboxes" \
  --header "X-API-KEY: {API_KEY}"

# List the chats of the connected account
curl --request GET \
  --url "https://api.unipile.com/v2/{ACCOUNT_ID}/chats" \
  --header "X-API-KEY: {API_KEY}"
200 OK · uzun ömürlü user token, yaklaşık 60 gün
200 OK · asla istemci kodunda veya uygulama dosyalarında değil
200 OK · is_valid, expires_at, data_access_expires_at
200 OK · bir account_id, değiştirilecek token yok

İstekler Meta'nın Long-Lived Access Tokens ve Access Tokens rehberlerinden alınmıştır. Unipile: Facebook Pages dokümantasyonu.

Kısaca Page token'lar

Bir Sayfa yöneticisinin uzun ömürlü user token'ı ile GET /me/accounts, her Sayfayı kendi token'ıyla döndürür; bu token'ın "son kullanma tarihi yoktur ve yalnızca belirli koşullarda sona erer veya geçersiz hale gelir". Ayrıntılar Facebook Page API rehberimizde; bu token ile yayın yapmak için bir Sayfada kendi token'ıyla nasıl paylaşım yapılacağına bakın.

Geçerlilik süresi

Facebook Access Token Ne Kadar Geçerlidir?

Meta'ya göre kısa ömürlü bir user token yaklaşık bir ile iki saat, uzun ömürlü bir token ise yaklaşık 60 gün geçerlidir. Uzun ömürlü bir token'dan alınan Page token'ların ve bazı system user token'larının son kullanma tarihi yoktur. Bundan bağımsız olarak, bir kullanıcının verilerine erişim 90 günlük hareketsizliğin ardından sona erer.

Facebook Meta'ya göre token süreleri
Kısa ömürlü user token1 ile 2 saat
Uzun ömürlü user tokenYaklaşık 60 gün
Uzun ömürlü user token'dan Page tokenSon kullanma tarihi yok
System user tokenSüresiz veya 60 gün
Kullanıcı verilerine erişimSon etkinlikten 90 gün sonra
Token'ın sona ermesi, veri erişiminin sona ermesi değildir

Meta, "veri erişiminin sona erme süresinin, kullanıcının son etkin olduğu zamana göre 90 gün" olduğunu belirtir. Kullanıcı oturumu açık kalır, ancak uygulamanız yeniden yetkilendirilene kadar onun verilerini okuyamaz.

Hiçbir token kalıcı değildir: "süresiz" bir token bile kullanıcı uygulamanızı kaldırdığında, şifresini değiştirdiğinde veya rolünü kaybettiğinde çalışmayı bırakır. Meta şu uyarıyı yapar: "Bu sürelerin aynı kalacağına güvenmeyin."

Kaynaklar: Meta'nın Access Tokens, Long-Lived Access Tokens, Authorization vs. data access ve system user token'ları rehberleri. Son doğrulama: 17 Kasım 2026.

System user

Sunucudan Sunucuya İşler için System User Access Token'ları

Bir system user access token, bir kişiye değil, Business Manager'ınızdaki bir system user'a aittir. Meta'ya göre "uygulamanızın Ad nesneleri veya Sayfalar üzerinde programatik, otomatik işlemler yapmasını" sağlar. Business Settings'te oluşturulur.

Seçenek 1

Süresi hiç dolmaz

Yenileme yok; token sızıntısının kabul edilebilir bir risk olduğu durumlar için.

Seçenek 2, önerilen

60 gün sonra sona erer

set_token_expires_in_60_days=true değerini ayarlayın ve 60. günden önce fb_exchange_token ile yenileyin.

  • Yalnızca aynı işletme. System user ve uygulama aynı Business Manager'a aittir ve "kullanıcının erişimi yoksa istek reddedilir".
  • Önce Marketing API erişimi gerekir: standart erişim veya daha üstü.

Kaynaklar: Meta'nın Install apps and generate tokens ve Access Tokens rehberleri. Son doğrulama: 17 Kasım 2026.

Debug

Facebook Access Token debug_token ile Nasıl Kontrol Edilir

Bir app access token (veya uygulamanın bir geliştiricisinin user token'ı) ile GET /debug_token?input_token={TOKEN} çağrısını yapın. Yanıt geçerliliği, son kullanma tarihini, veri erişiminin bitiş tarihini ve verilen izinleri döndürür. Kod yazmadan kontrol için token'ı Access Token Debugger'a (developers.facebook.com/tools/debug/accesstoken) yapıştırın.

Facebook debug_token ne döndürür
is_validToken'ın hâlâ çalışıp çalışmadığı.
expires_atUnix zaman damgası olarak token'ın son kullanma tarihi; 0 son kullanma tarihi olmadığı anlamına gelir.
data_access_expires_atToken geçerli olsa bile veri erişiminin ne zaman biteceği.
scopesVerilen izinler; granular_scopes hedef ID'leri ekler.
app_id, user_idToken'ın kimin için oluşturulduğu.
profile_idPage token için Sayfa ID'si.

Üretimde bir Facebook access token'ın geçerli olup olmadığını kontrol etmek için yukarıdaki kod bloğunun 3. sekmesindeki isteği sunucunuzda düzenli olarak çalıştırın ve her iki tarihi her token ile birlikte saklayın. scopes içinde eksik bir izin, "bende çalışıyor, onlarda çalışmıyor" türündeki hataların çoğunu açıklar.

Kaynak: Meta'nın debug_token referansı (Graph API v27.0). Son doğrulama: 17 Kasım 2026.

Hatalar

Facebook Access Token Hataları: 190 Kodu ve Subcode'ları

190 hatası, Facebook access token'ın süresinin dolduğu veya geçersiz olduğu anlamına gelir. OAuthException olarak döner ve error_subcode değeri kullanıcıdan ne istemeniz gerektiğini söyler. Aynı token ile yeniden denemek sorunu asla çözmez.

Facebook Graph API ne döndürür

{ "error": { "type": "OAuthException", "code": 190, "error_subcode": 460, "fbtrace_id": "EJplcsCHuLu" } }

190 error_subcode'u okuyun, Meta desteği için fbtrace_id'yi saklayın
SubcodeAnlamıNe yapmalı
458Uygulama yüklü değilKullanıcının yeniden giriş yapmasını sağlayın
459Kullanıcı güvenlik kontrolündeKullanıcı facebook.com'a giriş yapar
460Şifre değiştiKullanıcının yeniden giriş yapmasını sağlayın
463Token'ın süresi dolduYeniden giriş, ardından yeniden değişim
464Onaylanmamış kullanıcıKullanıcı facebook.com'a giriş yapar
467Geçersiz tokenKullanıcıyı yeniden bağlayın
492Sayfada uygun rol yokMevcut bir yöneticiden yeni token
Subcode 458
AnlamıUygulama yüklü değil
Ne yapmalıKullanıcının yeniden giriş yapmasını sağlayın
Subcode 459
AnlamıKullanıcı güvenlik kontrolünde
Ne yapmalıKullanıcı facebook.com'a giriş yapar
Subcode 460
AnlamıŞifre değişti
Ne yapmalıKullanıcının yeniden giriş yapmasını sağlayın
Subcode 463
AnlamıToken'ın süresi doldu
Ne yapmalıYeniden giriş, ardından yeniden değişim
Subcode 464
AnlamıOnaylanmamış kullanıcı
Ne yapmalıKullanıcı facebook.com'a giriş yapar
Subcode 467
AnlamıGeçersiz token
Ne yapmalıKullanıcıyı yeniden bağlayın
Subcode 492
AnlamıSayfada uygun rol yok
Ne yapmalıMevcut bir yöneticiden yeni token

Çok müşterili bir SaaS'ta 492 klasik durumdur: bir Sayfayı bağlayan yönetici ayrılır. Diğer kodlar Facebook API hataları tablomuzda.

Kaynak: Meta'nın Graph API error handling rehberi. Son doğrulama: 17 Kasım 2026.

Güvenlik

Facebook Access Token'ları Saklama ve Koruma

Her Facebook access token'ı, ait olduğu hesabın şifresi gibi ele alın: App Secret'ı ve app token'ları sunucunuzda tutun, user ve Page token'larını depolamada şifreleyin, sunucu çağrılarını appsecret_proof ile imzalayın ve bir müşteri bağlantısını kestiği anda token'ları silin.

  • Gizli bilgiler yalnızca sunucuda. Meta: "App access token'ları asla istemci tarafı koda veya uygulama dosyalarına gömmeyin" ve "App access token'ları yalnızca sunucudan sunucuya çağrılarda kullanın".
  • Client token'lar herkese açıktır. Meta bunların "gizli olmadığını" belirtir: hassas hiçbir işlemi yetkilendirmek için kullanmayın.
  • Çağrıları appsecret_proof ile imzalayın. Meta bunu "app secret'ı anahtar olarak kullanan, access token'ınızın bir sha256 hash'i" olarak tanımlar; uygulama panosunda Require App Secret seçeneğini etkinleştirin.
  • Depolamada şifreleme, aktarımda HTTPS. Token'ları log'lardan ve URL'lerden uzak tutun.
  • Token başına bir kayıt. Kullanıcıyı, Sayfayı, uygulamayı ve expires_at değerini saklayın.
  • Bağlantı kesilince temizleyin. Bir kullanıcı ayrıldığında token'ı silin.

Kaynaklar: Meta'nın Access Tokens ve Securing Requests rehberleri. Son doğrulama: 17 Kasım 2026.

Unipile ile

Token Yönetimini Atlayın: Kullanıcılarınızın Facebook Hesaplarını Bağlayın

Unipile ile her kullanıcı Facebook hesabını Hosted Auth üzerinden bir kez bağlar. Yönettikleri Sayfalar aynı account_id üzerinde gelir ve API'yi kendi anahtarınızla (X-API-KEY) çağırırsınız. Sizin tarafınızda Meta token'ı, Meta uygulaması ve App Review yoktur.

SoruMeta access token'larıUnipile bağlı hesabı
Ne saklarsınızKullanıcı başına bir token, ayrıca Sayfa, yönetici ve uygulama başına birer tokenKullanıcı başına bir account_id ve tek bir API anahtarı
Neyi izlersinizHer token için expires_at ve data_access_expires_atmetadata.products_connection_status içinde Sayfa başına bir durum
Neyi yenilersiniz60. günden önce uzun ömürlü değişim veya yeniden girişDeğiştirilecek Meta token'ı yok
190 hatasındaSubcode'u okuyun, ardından kullanıcıdan yeniden giriş isteyinGerekirse kullanıcı Hosted Auth ile yeniden bağlanır
Ne saklarsınız
Meta token'larıKullanıcı başına bir token, ayrıca Sayfa, yönetici ve uygulama başına birer token
UnipileKullanıcı başına bir account_id ve tek bir API anahtarı
Neyi izlersiniz
Meta token'larıHer token için expires_at ve data_access_expires_at
Unipilemetadata.products_connection_status içinde Sayfa başına bir durum
Neyi yenilersiniz
Meta token'ları60. günden önce uzun ömürlü değişim veya yeniden giriş
UnipileDeğiştirilecek Meta token'ı yok
190 hatasında
Meta token'larıSubcode'u okuyun, ardından kullanıcıdan yeniden giriş isteyin
UnipileGerekirse kullanıcı Hosted Auth ile yeniden bağlanır

Bağlı bir hesap mesajları, Sayfa gelen kutularını, gönderileri, yorumları ve tepkileri kapsar. Bir Sayfa konuşmalarını yanıtlayabilir ve gönderi yayınlayabilir, ancak bir konuşma başlatamaz. Yukarıdaki 4. sekmeye ve Facebook Messenger API sayfamıza bakın.

Uyumluluk

Her kullanıcı kendi hesabını bağlar

Unipile bağımsız bir şirkettir; resmi bir Meta uygulaması veya Meta Partner değildir. Kimliği doğrulanmış her kullanıcı adına hareket eder ve her kullanıcı Meta'nın koşullarına bağlı kalır.

Token altyapısı kurmadan Facebook üzerinde geliştirin

Her kullanıcı Facebook hesabını bir kez bağlar; Facebook, LinkedIn, WhatsApp ve e-posta için tek bir API kullanırsınız. 7 gün ücretsiz deneme.

Avrupa Komisyonu
AB Düzenlemesi Digital Markets Act (DMA)

Her kullanıcı kendi hesabını bağlar, profil depolama yok. Unipile bir Meta İş Ortağı değildir. Daha fazla bilgi edinin

Tüm Facebook API endpoint'leri tek bir yerde

Hesap bağlandıktan sonra Unipile ile kullanılabilen tüm Facebook endpoint'lerine göz atın veya izinler, limitler ve hatalar için eksiksiz Facebook API rehberimizi okuyun.

Facebook API Access Token SSS

Token süresi, yenileme, geçerlilik kontrolü, saklama ve 190 hatası hakkında hızlı yanıtlar.

Tam anlamıyla hayır. Uzun ömürlü bir user token yaklaşık 60 gün geçerlidir. Ondan türetilen Page token'ların ve bazı system user token'larının son kullanma tarihi yoktur, ancak kullanıcı uygulamanızı kaldırdığında, şifresini değiştirdiğinde veya rolünü kaybettiğinde yine de çalışmayı bırakırlar. Bir yeniden bağlanma akışı planlayın.

OAuth anlamında hayır: Meta, Facebook Login için herhangi bir refresh_token grant'i belgelemez. Geçerli bir kısa ömürlü token'ı fb_exchange_token ile değiştirirsiniz; bir token'ın süresi dolduğunda kullanıcı yeniden giriş yapar. Yerel mobil uygulamalarda Meta, kişi uygulamanızı kullandığında uzun ömürlü token'ları günde bir kez yeniler.

Çünkü 60 gün bir üst sınırdır, bir garanti değil. Kullanıcı şifresini değiştirdiğinde, uygulamanızı kaldırdığında, bir güvenlik kontrolüne takıldığında veya Sayfadaki rolünü kaybettiğinde token erken sona erer; Meta da sürelerin "uyarı yapılmadan değişebileceği veya erken sona erebileceği" konusunda uyarır. Hangi durumla karşılaştığınızı anlamak için 190 hatasının error_subcode değerini okuyun.

App access token'ınızla GET /debug_token?input_token={TOKEN} çağrısını yapın ve is_valid, expires_at, data_access_expires_at ile scopes alanlarını okuyun. Tek seferlik bir kontrol için token'ı Meta'nın Access Token Debugger aracına yapıştırın.

Evet, onlara şifre gibi davranırsanız: depolamada şifreleyin, log'lardan ve istemci kodundan uzak tutun, App Secret'ı ve app token'ları yalnızca sunucudan sunucuya çağrılarda kullanın. Sunucu çağrılarını appsecret_proof ile imzalayın.

492 subcode'lu 190 hatası geçersiz bir oturum anlamına gelir: bir Page access token'ın arkasındaki kullanıcının artık Sayfada uygun bir rolü yoktur. Mevcut bir yöneticiden yeni bir Page token alın.

Hayır. Unipile bağımsız bir şirkettir: Meta Partner veya resmi bir Meta uygulaması değildir ve Meta tarafından desteklenmez, sponsorluğu yapılmaz veya onaylanmaz. Facebook, Meta Platforms, Inc.'in ticari markasıdır.

Hayır. Unipile'ı API anahtarınız ve bağlı her kullanıcının account_id değeriyle çağırırsınız. Kullanıcılar Facebook hesaplarını ve yönettikleri Sayfaları Unipile'ın hosted authentication akışı üzerinden bağlar: sizin tarafınızda Meta uygulaması, App Secret veya App Review yoktur.

Digital Markets Act'e uygun olarak tasarlanmıştır: her kullanıcı kendi hesabını bağlar ve Unipile, kullanıcı profillerini saklamadan onlar adına hareket eder. Ayrıntılar Digital Markets Act sayfamızda.

Evet. Bağlı her hesap Meta'nın Hizmet Koşullarına tabi olmaya devam eder. API'yi müşteri desteği, CRM ve doğrudan konuşmalar gibi meşru senaryolar için kullanın; spam ve izinsiz otomasyon hesapların kısıtlanmasına yol açabilir.

Hâlâ sorularınız mı var? Ekibimiz yardıma hazır.

Bir uzmanla görüşün