For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /tr/docs/mobile/api.md (or send Accept: text/markdown).
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.
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.
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.