Bu bölüm, Teable API’yi hızlı ve güvenli bir şekilde kullanmaya başlamanıza yardımcı olur.
Temel URL
- Teable Cloud:
https://app.teable.ai
- Kendi sunucunuzda barındırılan sürüm: kendi alan adınızı kullanın (örneğin
https://teable.example.com)
Bu belgelerdeki tüm API yolları temel URL’ye göredir ve /api ile başlar.
Kimlik doğrulama
Teable API’leri Bearer token’ları kullanır:
Aşağıdakilerden birini kullanabilirsiniz:
- Kişisel Erişim Token’ı: betikler, dahili araçlar ve sunucu tarafı entegrasyonları için en uygun seçenektir. Erişim Token’ı sayfasına bakın.
- OAuth Erişim Token’ı: son kullanıcıların erişim izni verdiği çok kiracılı entegrasyonlar için en uygun seçenektir. OAuth Uygulaması sayfasına bakın.
Kimlikler (spaceId / baseId / tableId / viewId / fieldId / recordId)
Çoğu uç nokta tbl..., rec... gibi kimlikler gerektirir. Kimlikleri Alma sayfasına bakın.
Kapsamlar ve izinler
Hem Kişisel Erişim Token’larının hem de OAuth token’larının izin kapsamları vardır. 403 hatası alırsanız bu genellikle token’ın gerekli kapsamı içermediği anlamına gelir.
Sayfalama (take / skip)
Birçok liste uç noktası şunları destekler:
take: döndürülecek öğe sayısı (bazı uç noktalar bu sayıyı sınırlar; örneğin istek başına en fazla 100 Kayıt döndürülür, bu nedenle skip ile sayfalama yapın)skip: atlanacak öğe sayısı
Alan anahtarları ve hücre biçimi
Bazı API’ler, Kayıt Alanlarının nasıl gösterileceğini belirlemenize olanak tanır:
fieldKeyType: name (varsayılan) / id / dbFieldNamecellFormat: json (varsayılan) / text
Kayıt Alanı değeri yapıları için Kayıt Alanı Arayüzü sayfasına bakın.
Sonraki adımlar
Son değiştirilme tarihi 4 Eylül 2026
