> ## Documentation Index
> Fetch the complete documentation index at: https://help.teable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# نظرة عامة على API

> كل ما تحتاج إليه لبدء استدعاء Teable API: عنوان URL الأساسي والمصادقة والمعرّفات وأنماط الطلبات الشائعة.

يساعدك هذا القسم على بدء استخدام Teable API بسرعة وأمان.

## عنوان URL الأساسي

* **Teable السحابية**: `https://app.teable.ai`
* **الاستضافة الذاتية**: استخدم نطاقك الخاص (على سبيل المثال `https://teable.example.com`)

جميع مسارات API في هذه الوثائق مرتبطة بعنوان URL الأساسي وتبدأ بـ `/api`.

## المصادقة

تستخدم واجهات Teable API **رموز Bearer**:

```bash theme={null}
curl -H 'Authorization: Bearer __token__' \
  'https://app.teable.ai/api/table/__tableId__/record'
```

يمكنك استخدام أحد الخيارين التاليين:

* **رمز الوصول الشخصي**: الأنسب للنصوص البرمجية والأدوات الداخلية وعمليات التكامل من جانب الخادم. راجع [رمز الوصول](/ar/api-doc/token).
* **رمز وصول OAuth**: الأنسب لعمليات التكامل متعددة المستأجرين التي يمنح فيها المستخدمون النهائيون حق الوصول. راجع [تطبيق OAuth](/ar/api-doc/oauth).

## المعرّفات (spaceId / baseId / tableId / viewId / fieldId / recordId)

تتطلب معظم نقاط النهاية معرّفات مثل `tbl...` و`rec...`. راجع [الحصول على المعرّفات](/ar/api-doc/get-id).

## النطاقات والأذونات

تُقيّد رموز الوصول الشخصية ورموز OAuth بنطاقات أذونات محددة. إذا تلقيت الخطأ 403، فهذا يعني عادةً أن الرمز لا يتضمن النطاق المطلوب.

* راجع [رموز الأخطاء](/ar/api-doc/error-code)
* مرجع نطاقات OAuth: [تطبيق OAuth](/ar/api-doc/oauth#available-scopes)

## التقسيم إلى صفحات (take / skip)

تدعم العديد من نقاط النهاية التي تعرض قوائم ما يلي:

* `take`: عدد العناصر المطلوب إرجاعها (تضع بعض نقاط النهاية حدًا أقصى لهذا العدد؛ فمثلًا، الحد الأقصى للسجلات هو 100 لكل طلب، لذا تنقّل بين الصفحات باستخدام `skip`)
* `skip`: عدد العناصر المطلوب تخطيها

## مفاتيح الحقول وتنسيق الخلايا

تتيح لك بعض واجهات API التحكم في كيفية تمثيل حقول السجلات:

* `fieldKeyType`: `name` (الافتراضي) / `id` / `dbFieldName`
* `cellFormat`: `json` (الافتراضي) / `text`

للاطلاع على بُنى قيم حقول السجلات، راجع [واجهة حقول السجلات](/ar/api-doc/record/interface).

## الخطوة التالية

* **إذا كنت تريد جلب البيانات فقط**: [الحصول على السجلات](/ar/api-doc/record/get)
* **إنشاء السجلات أو تحديثها أو حذفها**: [إنشاء السجلات](/ar/api-doc/record/create)، [تحديث سجل](/ar/api-doc/record/update)، [حذف السجلات](/ar/api-doc/record/delete)
* **رفع المرفقات**: [رفع مرفق](/ar/api-doc/record/upload-attachment)
* **القائمة الكاملة لنقاط النهاية**: استخدم شريط التنقل الأيسر ضمن **مرجع API**