المسار
GET /api/table/{tableId}/record الطلب
معلمات المسار
tableId (string): المعرّف الفريد للجدول (كيفية الحصول عليه).معلمات الاستعلام الأساسية
جميع المعلمات اختياريةstring
يحدد معرّف طريقة العرض التي ستُجلب السجلات منها. إذا لم تحدده، فستُرجع السجلات بترتيب وقت إنشائها، بما يشمل جميع السجلات والحقول.
number
يحدد عدد السجلات المطلوب جلبها، وقيمته القصوى 100. لقراءة المزيد من السجلات، تنقّل بين صفحات البيانات باستخدام
skip وtake (راجع التقسيم إلى صفحات).ينطبق حد 100 سجل على مفاتيح API الشخصية في Teable السحابية التي أُنشئت في 10 سبتمبر 2026 أو بعده. أما المفاتيح التي أُنشئت قبل ذلك التاريخ، ورموز OAuth والمكونات الإضافية، والنسخ ذاتية الاستضافة، فلا تزال تقبل ما يصل إلى 1000 سجل، لكن يظل الحجم الموصى به للصفحة 100 سجل.number
يحدد عدد السجلات المطلوب تخطيها، ويُستخدم للتقسيم إلى صفحات.
string
افتراضي:"name"
يحدد نوع مفتاح الحقول في السجلات. القيم الممكنة:
name: استخدام أسماء الحقول كمفاتيح (الافتراضي)id: استخدام معرّفات الحقول كمفاتيحdbFieldName: استخدام قيم dbFieldName للحقول كمفاتيح
string
افتراضي:"json"
يحدد تنسيق إرجاع قيم الخلايا. القيم الممكنة:
json: إرجاع بيانات JSON منظّمة (الافتراضي)text: إرجاعها بتنسيق نص عادي
string[]
إذا كنت تحتاج إلى حقول محددة فقط، فحددها باستخدام هذه المعلمة. وإلا، فستُجلب جميع الحقول المرئية. تعتمد قيم المعلمة على إعداد fieldKeyType (أي استخدام أسماء الحقول أو معرّفاتها أو dbFieldName).
string
مصفوفة من كائنات الفرز تحدد كيفية ترتيب السجلات.
string
كائن شروط استعلام مركبة لتصفية النتائج. يدعم شروط الاستعلام المركبة استنادًا إلى الحقول والعوامل والقيم.
string[]
البحث عن سجلات تطابق الحقول والقيم المحددة.
معلمات الاستعلام المتقدمة
معلمات الاستعلام المتقدمة
string
مصفوفة من كائنات التجميع تحدد كيفية تجميع السجلات.
string[]
مصفوفة معرّفات المجموعات المطلوب طيها.
string[]
تصفية السجلات المحددة حسب معرّفات السجلات.
boolean
عند تحديد viewId، يؤدي ضبط هذه القيمة على true إلى تجاهل عوامل التصفية والفرز والإعدادات الأخرى الخاصة بطريقة العرض.
string[]
تصفية السجلات القابلة للتحديد من الجدول المرتبط بواسطة خلية الارتباط المحددة. على سبيل المثال، في حقول العلاقات من واحد إلى متعدد أو من واحد إلى واحد، لن تظهر معرّفات السجلات المحددة مسبقًا.
string[]
تصفية السجلات المحددة بالفعل من الجدول المرتبط بواسطة خلية الارتباط هذه. ملاحظة: لن تسري قيم viewId وfilter وorderBy في هذه الحالة، لأن للسجلات المحددة ترتيبها الخاص.