> ## Documentation Index > Fetch the complete documentation index at: https://supastack.dev/llms.txt > Use this file to discover all available pages before exploring further. > For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt # Mobil API Uygulamanın sunucuyla nasıl konuştuğu — oturumlar, erişilebilirlik ve yükler. ## Başlangıç seviyesinde izlenecek yol Önkoşullar: Aşağıdaki iki başlangıç kılavuzunu okuyun ve Mobil yerel kurulumu tamamlayın. Expo değerlerini `apps/mobile/.env.local`'ye koyun; `EXPO_PUBLIC_API_URL`'yi cihazınızın ulaşabileceği bir arka uç ana bilgisayarına ayarlayın. Yalnızca mobil cihazlara yönelik bir ödeme işleminin web arka ucu yoktur, bu nedenle ayrı bir tane başlatın veya bağlayın. Başarılı bir Expo dışa aktarımı, cihazın veya satın almanın kabul edildiğini değil, JavaScript paketini kanıtlar. Kısa terimler: Çalışma alanı, bir ekibin ayrı kullanıcıları, verileri ve ayarlarıdır. Sunucu güvenilir arka uçtur; sağlayıcı anahtarlarını tarayıcı ve telefon kodundan uzak tutun. Geçiş, tabloları oluşturan veya güncelleyen sürümlü bir veritabanı değişikliğidir. Yapay zeka modeli yanıt veren motordur; model kataloğu, sunucunun mevcut model kimlikleri ve fiyatlarının listesidir. Sağlayıcı yapay zeka, e-posta veya faturalandırma hizmeti gibi bir dış hizmettir. Yetki, bir çalışma alanının bir özelliği kullanmasına olanak tanıyan bir yetkidir. Web kancası, bir hizmetin başka bir hizmetin URL'sine gönderdiği bir mesajdır. 1. `apps/mobile/.env.local`'de, `EXPO_PUBLIC_API_URL`'yi telefonunuzdan erişilebilen çalışan arka uç adresine ayarlayın; `localhost`'yi fiziksel bir cihazdan kullanmayın. 2. Expo'yi başlatmak, oturum açmak ve çalışma alanını, ayarları ve sohbet ekranlarını açmak için Mobil yerel kurulumu izleyin. 3. Aynı çalışma alanından kimliği doğrulanmış veriler bekleyin. İstekler zaman aşımına uğrarsa telefonu ve bilgisayar ağını kontrol edin ve arka ucu yalnızca mobil ödemede ayrı olarak başlatın. Özel kod için, sağlanan `prompts/README.md` ile başlayın ve en yakın istemi kopyalayın: Bir uygulama ekranı için `prompts/new-app-screen.md` veya genel bir sayfa için `prompts/new-landing-page.md`. Sunucu, veritabanı veya sağlayıcı çalışması için kodlama temsilcinize bu kılavuzun görevini verin ve ondan `AGENTS.md`, `.ai/PROJECT_CONTEXT.md` ve eşleşen `.ai/` aynalarını okumasını isteyin; burada adı geçen kaynak dosyaların tamamını inceleyin; düzenlemeden önce dosyaları ve kontrolleri listeleyin; çalışma alanı sahipliğini ve yalnızca sunucuya ait sırları koruyun; ve size farkı göstereceğim. İstediğiniz davranışı, giriş ve çıkış alanlarını, izin verilen rolleri, beklenen başarıyı ve hataları ve test hesabını, sağlayıcıyı veya cihazı ona bildirin. Örnek değerleri kullanın; asla gerçek bir sırrı yapıştırmayın. [Başlamadan önce](https://supastack.dev/tr/docs/web/before-you-start.md) [Terminal temelleri](https://supastack.dev/tr/docs/web/terminal-basics.md) [Mobil yerel kurulum](https://supastack.dev/tr/docs/mobile/ship-in-5-minutes.md) [Aracı istemleri ve proje belleği](https://supastack.dev/tr/docs/web/agents.md) ## Yerel kapsamı anlayın Expo, çalışma alanı, ayarlar, sohbet ve RevenueCat satın alma yüzeylerinin yanı sıra yerel kimlik doğrulama/oturum ve derin bağlantıları içerir. Paylaşılan iş davranışı ve yetkilendirme, web arka ucunda/paketlerinde kalır; `apps/mobile/src` kapsamındaki yerel istemciler, sağlayıcı kimlik bilgilerini eklemeden bu API'leri çağırır. ## Oturum kimlik doğrulamalı BFF'yi kullanın `/api/mobile` rotaları yetkilendirmeyi, RevenueCat satın alma kullanılabilirliğini ve sunucu senkronizasyonunu, organizasyonu, üyeleri, davetiyeleri, denetimi, API anahtarlarını, web kancalarını, etki alanlarını, programları ve özellik isteklerini kapsar. Çalışma alanı sahipliğini ve rol kontrollerini korurlar. `sk_` taşıyıcı anahtar `/api/v1` kamu sözleşmesinden farklıdırlar. Cihazınızın erişebildiği `EXPO_PUBLIC_API_URL`'yi ve yapılandırılmış orijini/şemayı kullanın; genel Expo değişkenleri hiçbir zaman sağlayıcı kimlik bilgilerini içermez. ## Yerel hedeflerde doğrulama Desteklemeyi düşündüğünüz cihazda/yapıda yükleme/hata/boş durumlarını, yeniden bağlanmayı, süresi dolmuş oturumu, yasak yönetim eylemlerini ve derin bağlantı iadelerini kontrol edin. Expo dışa aktarımı, yerel teslimatı veya satın alma kabulünü değil, paketlenmeyi kanıtlar. [Tüm API rotaları](https://supastack.dev/tr/docs/web/project-structure.md) [Yerel oturum akışı](https://supastack.dev/tr/docs/mobile/authentication.md) ## Kurulum ve yapılandırma Uygulama, /api/mobile altındaki API'yi ve sürümlenmiş /api/v1 yüzeyini, web uygulamasının cookie varsayımları yerine üyenin oturumuyla çağırır. EXPO_PUBLIC_API_URL, istemcinin bildiği tek kaynaktır; tasarım gereği herkese açıktır ve sır taşımaz. Oturum token'ları Better Auth Expo akışından gelir ve yerel güvenli depolamada tutulur — asla düz AsyncStorage'da ya da gömülü yapılandırmada değil. ``` GET /api/mobile/entitlement # access state for the member GET /api/mobile/organization # active workspace context GET /api/mobile/usage # current-month AI spend, meter caps, and credit balance GET /api/mobile/appearance # synced appearance bundle (GET/PUT) POST /api/v1/ai-tasks # authorized work, same as web Session: /api/auth/* (Better Auth Expo flow) # Optional server-only token for authenticated Expo push sends: # EXPO_ACCESS_TOKEN= ``` ## Uygulama iş akışı İlk kimliği doğrulanmış istekten önce saklanan oturumu çözün, sunucu süre aşımı bildirdiğinde yenileyin ve iptal edildiğinde temiz çıkış yapın. Ulaşılamayan API ile geçersiz oturumu farklı durumlar olarak ele alın — biri yeniden dener, diğeri girişe döner. Yükleri web sözleşmesiyle aynı tutun: sunucu, hangi istemcinin çağırdığından bağımsız olarak aynı çalışma alanı, yetkilendirme ve doğrulama kurallarını uygular. ## Doğrulama ve sorun giderme Uçak modu hatalarını, oturum ortasında süresi dolan token'ları, iptal edilmiş oturumları ve saklanmış geçerli token'la soğuk başlangıcı test edin. Kapalı başarısız olan (reddedilen) istek doğrudur; açık başarısız olan, yayından önce düzeltilmesi gereken hatadır. ## Sonraki [Yerel UI ve temalandırma](https://supastack.dev/tr/docs/mobile/ui.md)