Hesap nasıl bağlanır?
Gerçek Meta, X ve TikTok hesaplarını OAuth ile bağlamak için adım adım rehber.
Özet
Uygulama varsayılan olarak gerçek OAuth kullanır. «Bağla» yalnızca ilgili sağlayıcı anahtarları `.env` içinde doluysa çalışır. Anahtar yoksa sessizce sahte bağlantı yapılmaz; isteğe bağlı «Demo bağla» ayrı ve etiketlidir.
1. Ortam değişkenleri
TanerPC’de kök dosya: C:\Users\Administrator\Desktop\sosyal_medya\.env
- Facebook: META_APP_ID, META_APP_SECRET, META_REDIRECT_URI
- Instagram: META_APP_ID, META_APP_SECRET, INSTAGRAM_REDIRECT_URI
- X (Twitter): X_CLIENT_ID, X_CLIENT_SECRET, X_REDIRECT_URI
- TikTok: TIKTOK_CLIENT_KEY, TIKTOK_CLIENT_SECRET, TIKTOK_REDIRECT_URI
Anahtarları yazdıktan sonra:
docker compose up -d --force-recreate app nuxt
2. Callback / Redirect URL’ler
Geliştirici konsollarına aynı URL’leri birebir ekleyin (sonunda slash olmadan):
http://localhost:8080/api/v1/social-accounts/oauth/callback/facebook
Meta for Developers → App → Facebook Login → Valid OAuth Redirect URIs
http://localhost:8080/api/v1/social-accounts/oauth/callback/instagram
Meta for Developers → aynı uygulama (Instagram Graph / Login ürünü)
X (Twitter)
http://localhost:8080/api/v1/social-accounts/oauth/callback/x
X Developer Portal → Project/App → User authentication → Callback URI / Redirect URL
TikTok
http://localhost:8080/api/v1/social-accounts/oauth/callback/tiktok
TikTok Developers → Login Kit → Redirect domain / URI
3. Meta (Facebook / Instagram)
- developers.facebook.com üzerinde uygulama oluşturun (tip: Business).
- Ürün ekleyin: Facebook Login ve Instagram Graph API / Instagram.
- Valid OAuth Redirect URIs’e yukarıdaki Facebook ve Instagram callback URL’lerini ekleyin.
- App ID / App Secret’ı `.env` →
META_APP_ID,META_APP_SECRET. - Geliştirme modunda yalnızca uygulama rollerindeki (Admin/Developer/Tester) Meta kullanıcıları bağlanabilir.
- App Review: Canlı (Live) moda geçmek ve geniş izinler (
pages_manage_posts,instagram_content_publish, ads) için Meta incelemesi gerekir. Yerel test için Development + test kullanıcıları yeterlidir. - Instagram: hesap Business/Creator olmalı ve bir Facebook Sayfası’na bağlı olmalıdır.
4. X (Twitter)
- developer.x.com → proje / uygulama.
- User authentication ayarlarında OAuth 2.0’ı açın; Type of App: Web App.
- Callback URI olarak X URL’sini ekleyin; Website URL:
http://localhost:8080. - Client ID / Client Secret →
X_CLIENT_ID,X_CLIENT_SECRET. - Scopes (uygulama zaten ister):
tweet.read,tweet.write,users.read,offline.access. - Elevated / paid erişim bazı yazma özelliklerinde gerekebilir; OAuth bağlantısı genelde temel projede çalışır.
5. TikTok
- developers.tiktok.com → uygulama.
- Login Kit + Content Posting API ürünlerini ekleyin.
- Redirect URI’ye TikTok callback’ini yazın; domain allowlist’e
localhostekleyin (TikTok kurallarına göre). - Client Key / Secret →
TIKTOK_CLIENT_KEY,TIKTOK_CLIENT_SECRET. - Sandbox / test kullanıcıları ile önce Login Kit akışını doğrulayın; production publish için TikTok incelemesi gerekir.
6. Uygulamada bağlama
- http://localhost:8080 adresine giriş yapın.
- Hesaplar sayfasında sağlayıcı «canlı OAuth hazır» görünmeli.
- «Bağla» → sağlayıcı giriş ekranı → izinler → callback → tekrar Hesaplar.
- Hata olursa URL’deki
?error=mesajına ve Laravel log’a bakın.
7. Demo bağla
Kimlik bilgisi yokken kartlarda «Demo bağla» görünür. Bu, mock hesap oluşturur; gerçek ağ hesabı değildir. Gerçek test için anahtarları doldurun ve yalnızca «Bağla» kullanın.
Tam rehber ayrıca proje deposunda / docs klasöründe tutulur.