نقاط السجلات والتعليقات واكتشاف الحقول

المفتاح يصل إلى: هوية الاتصال، واكتشاف الوحدات وحقولها، وقراءة السجلات وكتابتها وإسنادها وحذفها، وتعليقات السجلات. أجسام الكتابة مفاتيحها معرّفات الحقول (slug) لا أسماؤها.

7 دقائقحُدّث 27‏/10‏/2026

افتح في كورتيكسا

كيف يعمل

المسار الأساسي: https://{HOST}/api/v1.

الاكتشاف

الطريقة والمسار

النطاق

الغرض

GET /object/active

بلا

الوحدات النشطة (المعرّف والاسم والأيقونة)

GET /object/field/active/:objectSlug

read

حقول الوحدة: المعرّف والاسم والنوع

القراءة (read.{unit})

المسار

الغرض

GET /object/data/:objectSlug

قائمة مرقّمة

GET /object/data/:objectSlug/:dataSlug

سجل واحد

POST /object/data/:objectSlug/search

بحث بفلاتر

GET /object/data/:objectSlug/lookup

بحث خفيف للإكمال التلقائي

GET /object/data/facets/:objectSlug

أعداد مجمّعة

GET /object/data/:objectSlug/field-options/:fieldSlug

القيم المسموحة لحقل

GET /object/data/select-options/:objectSlug/:fieldSlug

خيارات حقل الاختيار

GET /object/data/:objectSlug/:dataSlug/relations/:relationSlug

السجلات المرتبطة

GET /object/data/:objectSlug/:dataSlug/logs

سجل تغييرات السجل

الكتابة

الطريقة والمسار

النطاق

POST /object/data/:objectSlug

create

PUT /object/data/:objectSlug/:dataSlug

update

POST /object/data/:objectSlug/bulk-update

update

PATCH /object/data/:objectSlug/:dataSlug/assignees

assign

POST /object/data/:objectSlug/bulk-assign

assign

DELETE /object/data/:objectSlug/:dataSlug

delete

POST /object/data/:objectSlug/bulk-delete

delete

DELETE /object/data/:objectSlug/bulk/all

delete

جسم الكتابة: { "data": { "name-8fk2": "سارة", "phone-p0zx": "+9665..." } }. استخدم معرّف الحقل من الاكتشاف. الاسم الظاهر قد يُرفض في حقل إلزامي.

السجلات المنشأة عبر API تأخذ القيم الافتراضية لحقولها.

إن أرسلت admin_slug في PUT دون صلاحية إسناد، يُحفظ الباقي ويرجع تنبيه ASSIGN_SCOPE_DENIED في warnings. طابق على code لا على النص.

التعليقات (كلها read.{unit})

المسار

الغرض

GET/POST /comments/:objectSlug/:dataSlug

عرض التعليقات أو إضافة تعليق مع إشارات وصور

PUT/DELETE /comments/:objectSlug/:dataSlug/:comment

تعديل أو حذف تعليق كتبه المفتاح

GET /comments/.../:comment/replies

الردود

POST /comments/.../:comment/reply

رد

POST /comments/.../:comment/react

تفاعل برمز تعبيري

التعليق يُكتب باسم عضو المفتاح. التعديل والحذف للكاتب فقط، ولا يملك المفتاح تجاوز المالك.

حقول الحملة الإعلانية

مع المفتاح فقط يمكن كتابة حقول الحملة والمجموعة الإعلانية والإعلان ونموذج العميل، مثلاً لعملاء منصة إعلانية بلا ربط مباشر. أرسل معرّف خيار موجود، أو { "id": "...", "name": "..." }، أو اسماً نصياً. الاسم حتى 255 حرفاً.