Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
58 changes: 58 additions & 0 deletions ar/api-doc/error-code.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
---
title: "رموز الأخطاء"
---

<Note>تتبع واجهة Teable Web API دلالات رموز حالة HTTP.</Note>

* 2xx
يشير إلى نجاح العملية
* 4xx
أخطاء من جانب العميل
* 5xx
أخطاء من جانب الخادم

تُرجع استجابات الأخطاء نصًا بترميز JSON يحتوي على حقلي الخطأ والمعلومات. فيما يلي مثال على نص استجابة خطأ:

```json
{
"message": "not allowed to operate space|read on spcxxxxxx",
"status": 403,
"code": "restricted_resource"
}
```

## رموز حالة النجاح

### 200 OK

اكتمل الطلب بنجاح.

### 201 Created

اكتمل الطلب بنجاح وأُنشئ مورد جديد.

## رموز الأخطاء

### 400 Bad Request

تعذّر تحليل نص الطلب على أنه `JSON`، أو أن معلمات الإدخال في النص لا تستوفي متطلبات المواصفات.

### 401 Unauthorized

محاولة وصول غير مصرّح بها إلى API.

### 403 Forbidden

محاولة الوصول إلى مورد محمي باستخدام بيانات اعتماد API لا تتضمن الأذونات اللازمة.

### 404 Not Found

لم يُعثر على المسار أو المورد. يُرجع هذا الخطأ عند محاولة الوصول إلى مسار مورد غير موجود أو عندما لا تتطابق طريقة الطلب معه.

### 500 Internal Server Error

واجه الخادم حالة غير متوقعة.

### 503 Service Unavailable

الخدمة غير متاحة مؤقتًا، وقد يرجع ذلك إلى انتهاء مهلة المعالجة أو فشل الاتصال بقاعدة البيانات.
88 changes: 88 additions & 0 deletions ar/api-doc/get-id.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,88 @@
---
title: "الحصول على المعرّفات"
---

## SpaceId

انقر على المساحة المستهدفة، ثم انسخ من عنوان URL السلسلة التي تبدأ بـ 'spc'، مثال: `spcXXXXXXXXXX`

<img
src="/images/api/get-id/2026-05-29-get-id-space-id.png"
alt="معرّف المساحة في عنوان URL"
className="docs-screenshot"
/>

## BaseId

انقر على قاعدة البيانات المستهدفة، ثم انسخ من عنوان URL السلسلة التي تبدأ بـ 'bse'، مثال: `bseXXXXXXXXXX`

<img
src="/images/api/get-id/2026-05-29-get-id-base-id.png"
alt="معرّف قاعدة البيانات في عنوان URL"
className="docs-screenshot"
/>

## TableId {#tableid}

انقر على الجدول المستهدف، ثم انسخ من عنوان URL السلسلة التي تبدأ بـ 'tbl'، مثال: `tblXXXXXXXXXX`

<img
src="/images/api/get-id/2026-05-29-get-id-table-id.png"
alt="معرّف الجدول في عنوان URL"
className="docs-screenshot"
/>

## ViewId {#viewid}

انقر على طريقة العرض المستهدفة، ثم انسخ من عنوان URL السلسلة التي تبدأ بـ 'viw'، مثال: `viwXXXXXXXXXX`

<img
src="/images/api/get-id/2026-05-29-get-id-view-id.png"
alt="معرّف طريقة العرض في عنوان URL"
className="docs-screenshot"
/>

## FieldId {#fieldid}

**الطريقة الأولى:**

انقر على أيقونة "المزيد" (النقاط الثلاث) في الزاوية العلوية اليسرى، ثم اختر "التصميم" للانتقال إلى واجهة التصميم وعرض معرّفات جميع الحقول

<img
src="/images/api/get-id/2026-05-29-get-id-field-id-design-entry-en.png"
alt="فتح صفحة التصميم من قائمة المزيد"
className="docs-screenshot"
/>

<img
src="/images/api/get-id/2026-05-29-get-id-field-id-design-list.png"
alt="معرّفات الحقول في صفحة التصميم"
className="docs-screenshot"
/>

**الطريقة الثانية:**

انقر نقرًا مزدوجًا على رأس العمود أو اختر "تحرير الحقل" لفتح خصائص الحقل. يمكنك العثور على معرّف الحقل في قسم "اسم حقل قاعدة البيانات".

<img
src="/images/api/get-id/2026-05-29-get-id-field-id-edit-field-entry-en.png"
alt="فتح إعدادات الحقل من قائمة العمود"
className="docs-screenshot"
/>

<img
src="/images/api/get-id/2026-05-29-get-id-field-id-db-field-name-en.png"
alt="اسم حقل قاعدة البيانات ومعرّف الحقل"
className="docs-screenshot"
/>


## RecordId {#recordid}

وسّع نموذج تحرير السجل، ثم انسخ من عنوان URL السلسلة التي تبدأ بـ 'rec' بعد 'recordId='، مثال: `recXXXXXXXXXX`

<img
src="/images/api/get-id/2026-05-29-get-id-record-id.png"
alt="معرّف السجل في عنوان URL للسجل الموسّع"
className="docs-screenshot"
/>
Loading