مرجع واجهة البرمجة

هذه الصفحة للفرق التقنية في المنظمات التي تريد ربط أنظمتها بالمنصة، مثل نظام الموارد البشرية لنشر الفرص تلقائياً، أو نظام شؤون الطلاب لتوثيق الشهادات. إن كنت تستخدم المنصة من المتصفح فلا تحتاج إليها. تشرح كل عملية تتيحها واجهة البرمجة (API): عنوانها، وما تُرسله إليها، وما تتلقّاه منها. العنوان الأساسي ⁦/api/v1⁩، والنصوص بلغة الطلب. تُنشأ مفاتيح الربط من «الربط عبر الواجهة البرمجية» في لوحة المنظمة.

الإصدار 1.2.0
تنزيل ملف OpenAPI

M1 الهوية والحسابات والمنظمات

إنشاء حساب وشخص وجواز فارغ وموافقات

POST /api/v1/accounts

الصلاحية (الوثيقة 06): P-101
متاحة دون تسجيل دخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`proof`	`string`	نعم
`name_ar`	`string`	نعم
`name_latin`	`string`	لا
`governorate_code`	`string \| null`	لا
`residence_country`	`string`	لا
`password`	`string`	لا
`preferred_language`	`ar \| en`	لا
`accept_terms`	`boolean`	نعم
`consents`	`object[]`	لا
`national_id`	`string`	لا

إرسال رمز لمرة واحدة إلى رقم هاتف

POST /api/v1/auth/otp

الصلاحية (الوثيقة 06): P-101
متاحة دون تسجيل دخول
عند النجاح: 202

حقول الطلب
الحقل	النوع	إلزامي
`phone_e164`	`string`	نعم
`purpose`	`sign_up \| sign_in \| change_phone \| recovery`	نعم
`email`	`object`	لا

التحقق من رمز لمرة واحدة وإعادة إثبات قصير الأجل

POST /api/v1/auth/otp/verify

الصلاحية (الوثيقة 06): P-101
متاحة دون تسجيل دخول
عند النجاح: 200

حقول الطلب
الحقل	النوع	إلزامي
`phone_e164`	`string`	نعم
`purpose`	`sign_up \| sign_in \| change_phone \| recovery`	نعم
`email`	`object`	لا
`code`	`string`	نعم

بدء استرداد الحساب عند فقدان الهاتف

POST /api/v1/auth/recovery

الصلاحية (الوثيقة 06): public
متاحة دون تسجيل دخول
عند النجاح: 201, 202

حقول الطلب
الحقل	النوع	إلزامي
`old_phone_e164`	`string`	نعم
`proof`	`string`	نعم
`password`	`string`	لا
`recovery_code`	`string`	لا

رفع أدلة الهوية للاسترداد اليدوي

POST /api/v1/auth/recovery/{case_id}/evidence

الصلاحية (الوثيقة 06): public
متاحة دون تسجيل دخول
عند النجاح: 202

حقول الطلب
الحقل	النوع	إلزامي
`proof`	`string`	نعم
`file`	`string (uri)`	نعم

تسجيل الدخول بالهاتف وكلمة المرور أو بإثبات الرمز

POST /api/v1/auth/sessions

الصلاحية (الوثيقة 06): public
متاحة دون تسجيل دخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`phone_e164`	`string`	لا
`password`	`string`	لا
`proof`	`string`	لا

تسجيل الخروج

DELETE /api/v1/auth/sessions/current

الصلاحية (الوثيقة 06): P-102
تتطلب تسجيل الدخول
عند النجاح: 204

لا تحتاج إلى محتوى في الطلب (body).

تقديم العامل الثاني لهذه الجلسة (رمز تطبيق المصادقة أو رمز استرداد)

POST /api/v1/auth/sessions/current/mfa

الصلاحية (الوثيقة 06): P-102
تتطلب تسجيل الدخول
عند النجاح: 200

حقول الطلب
الحقل	النوع	إلزامي
`code`	`string`	نعم

تأكيد كلمة المرور أو رمز يُرسل إلى الرقم الحالي من جديد قبل تغيير حساس

POST /api/v1/auth/sessions/current/reauth

الصلاحية (الوثيقة 06): P-102
تتطلب تسجيل الدخول
عند النجاح: 204

حقول الطلب
الحقل	النوع	إلزامي
`password`	`string`	لا
`proof`	`string`	لا

شبكة الخبراء في الخارج

GET /api/v1/diaspora-network

الصلاحية (الوثيقة 06): P-601
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

رفع ملف (يُحجز حتى يُفحص)

POST /api/v1/files

الصلاحية (الوثيقة 06): P-201
تتطلب تسجيل الدخول
عند النجاح: 202

حقول الطلب
الحقل	النوع	إلزامي
`file`	`string (uri)`	نعم

المحافظات الأربع عشرة بلغة الطلب

GET /api/v1/governorates

الصلاحية (الوثيقة 06): public
متاحة دون تسجيل دخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

الحساب الخاص والأدوار والعضويات

GET /api/v1/me

الصلاحية (الوثيقة 06): P-102
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

تبديل الدور النشط والمنظمة

PUT /api/v1/me/active-role

الصلاحية (الوثيقة 06): P-102
تتطلب تسجيل الدخول
عند النجاح: 200

حقول الطلب
الحقل	النوع	إلزامي
`role`	`string`	نعم
`org_id`	`string \| null (uuid)`	لا

عرض الموافقات الخاصة وسجلها

GET /api/v1/me/consents

الصلاحية (الوثيقة 06): P-103
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

منح الموافقة على غرض ما أو سحبها

PUT /api/v1/me/consents/{purpose}

الصلاحية (الوثيقة 06): P-103
تتطلب تسجيل الدخول
عند النجاح: 200

حقول الطلب
الحقل	النوع	إلزامي
`granted`	`boolean`	نعم

طلب تصدير بياناتي (JSON وPDF)

POST /api/v1/me/data-exports

الصلاحية (الوثيقة 06): P-103
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`format`	`json \| pdf`	نعم

حذف حسابي بعد مهلة التراجع

POST /api/v1/me/deletion

الصلاحية (الوثيقة 06): P-103
تتطلب تسجيل الدخول
عند النجاح: 202

لا تحتاج إلى محتوى في الطلب (body).

ما أقدّمه من الخارج

GET /api/v1/me/diaspora-offer

الصلاحية (الوثيقة 06): P-601
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

تقديم الخبرة من الخارج

PUT /api/v1/me/diaspora-offer

الصلاحية (الوثيقة 06): P-601
تتطلب تسجيل الدخول
عند النجاح: 200

حقول الطلب
الحقل	النوع	إلزامي
`residence_country`	`string`	نعم
`offers`	`remote_work \| mentoring \| consulting \| volunteering \| return[]`	نعم
`fields`	`string[]`	لا

قبول دعوة أو عرض ملكية أو رفضهما

POST /api/v1/me/invitations/{membership_id}/decision

الصلاحية (الوثيقة 06): P-102
تتطلب تسجيل الدخول
عند النجاح: 204

حقول الطلب
الحقل	النوع	إلزامي
`accept`	`boolean`	نعم

بدء إعداد تطبيق مصادقة: مفتاح جديد يُعرض مرة واحدة

POST /api/v1/me/mfa/totp

الصلاحية (الوثيقة 06): P-102
تتطلب تسجيل الدخول
عند النجاح: 201

لا تحتاج إلى محتوى في الطلب (body).

تفعيل تطبيق المصادقة بأول رمز منه؛ ويعيد 10 رموز استرداد مرة واحدة

POST /api/v1/me/mfa/totp/confirm

الصلاحية (الوثيقة 06): P-102
تتطلب تسجيل الدخول
عند النجاح: 200

حقول الطلب
الحقل	النوع	إلزامي
`code`	`string`	نعم

تغيير رقم الهاتف بعد رمز يُرسَل إلى الرقم الجديد

PUT /api/v1/me/phone

الصلاحية (الوثيقة 06): P-102
تتطلب تسجيل الدخول
عند النجاح: 200

حقول الطلب
الحقل	النوع	إلزامي
`proof`	`string`	نعم

عرض جلساتي وأجهزتي

GET /api/v1/me/sessions

الصلاحية (الوثيقة 06): P-102
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

إنهاء كل الجلسات الأخرى

DELETE /api/v1/me/sessions

الصلاحية (الوثيقة 06): P-102
تتطلب تسجيل الدخول
عند النجاح: 204

لا تحتاج إلى محتوى في الطلب (body).

إنهاء جلسة

DELETE /api/v1/me/sessions/{session_id}

الصلاحية (الوثيقة 06): P-102
تتطلب تسجيل الدخول
عند النجاح: 204

لا تحتاج إلى محتوى في الطلب (body).

الحصول على رمز وصول ببيانات العميل

POST /api/v1/oauth/token

الصلاحية (الوثيقة 06): public
متاحة دون تسجيل دخول
عند النجاح: 200

حقول الطلب
الحقل	النوع	إلزامي
`grant_type`	`client_credentials`	نعم
`client_id`	`string`	نعم
`client_secret`	`string`	نعم
`scope`	`string`	لا

تسجيل منظمة (تنتظر الموافقة)

POST /api/v1/organizations

الصلاحية (الوثيقة 06): P-104
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`org_type`	`company \| government \| ngo \| international \| issuer \| syndicate \| training_provider \| investor`	نعم
`legal_name`	`string`	نعم
`registration_no`	`string`	نعم
`sector_code`	`A \| B \| C \| D \| E \| F \| G \| H \| I \| J \| K \| L \| M \| N \| O \| P \| Q \| R \| S \| U`	نعم
`governorate_code`	`string`	نعم
`women_led`	`boolean`	لا
`file_ids`	`string (uuid)[]`	نعم

ملف المنظمة

GET /api/v1/organizations/{org_id}

الصلاحية (الوثيقة 06): P-105
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

تعديل ملف المنظمة ومستنداتها

PATCH /api/v1/organizations/{org_id}

الصلاحية (الوثيقة 06): P-105
تتطلب تسجيل الدخول
عند النجاح: 200

حقول الطلب
الحقل	النوع	إلزامي
`org_type`	`company \| government \| ngo \| international \| issuer \| syndicate \| training_provider \| investor`	لا
`legal_name`	`string`	لا
`registration_no`	`string`	لا
`sector_code`	`A \| B \| C \| D \| E \| F \| G \| H \| I \| J \| K \| L \| M \| N \| O \| P \| Q \| R \| S \| U`	لا
`governorate_code`	`string`	لا
`women_led`	`boolean`	لا
`file_ids`	`string (uuid)[]`	لا

قائمة العملاء البرمجيين

GET /api/v1/organizations/{org_id}/api-clients

الصلاحية (الوثيقة 06): P-110
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

إنشاء عميل برمجي (يُعرض السرّ مرة واحدة)

POST /api/v1/organizations/{org_id}/api-clients

الصلاحية (الوثيقة 06): P-110
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`name`	`string`	نعم
`scopes`	`opportunities:read \| opportunities:write \| applications:read \| applications:write \| verification:read \| verification:write \| verification:bulk[]`	نعم
`rate_limit_per_min`	`integer`	لا

إلغاء عميل برمجي

DELETE /api/v1/organizations/{org_id}/api-clients/{client_id}

الصلاحية (الوثيقة 06): P-110
تتطلب تسجيل الدخول
عند النجاح: 204

لا تحتاج إلى محتوى في الطلب (body).

تبديل سرّ العميل

POST /api/v1/organizations/{org_id}/api-clients/{client_id}/rotation

الصلاحية (الوثيقة 06): P-110
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`overlap_hours`	`integer`	لا

قائمة الأعضاء وأدوارهم

GET /api/v1/organizations/{org_id}/members

الصلاحية (الوثيقة 06): P-106
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

دعوة عضو بدور محدد

POST /api/v1/organizations/{org_id}/members

الصلاحية (الوثيقة 06): P-106
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`phone_e164`	`string`	نعم
`role`	`recruiter \| verifier \| viewer \| trainer \| analyst`	نعم

تغيير دور عضو

PATCH /api/v1/organizations/{org_id}/members/{member_id}

الصلاحية (الوثيقة 06): P-106
تتطلب تسجيل الدخول
عند النجاح: 200

حقول الطلب
الحقل	النوع	إلزامي
`role`	`recruiter \| verifier \| viewer \| trainer \| analyst`	لا

إزالة عضو (تنتهي جلساته ومفاتيحه)

DELETE /api/v1/organizations/{org_id}/members/{member_id}

الصلاحية (الوثيقة 06): P-106
تتطلب تسجيل الدخول
عند النجاح: 204

لا تحتاج إلى محتوى في الطلب (body).

نقل الملكية إلى عضو آخر

POST /api/v1/organizations/{org_id}/ownership-transfer

الصلاحية (الوثيقة 06): P-107
تتطلب تسجيل الدخول
عند النجاح: 202

حقول الطلب
الحقل	النوع	إلزامي
`member_id`	`string (uuid)`	نعم
`my_new_role`	`recruiter \| verifier \| viewer \| trainer \| analyst`	لا

عملاء برمجيون للبيئة الفعلية بانتظار الموافقة

GET /api/v1/staff/api-clients

الصلاحية (الوثيقة 06): P-108
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

الموافقة على عميل برمجي للبيئة الفعلية أو رفضه

POST /api/v1/staff/api-clients/{client_id}/decision

الصلاحية (الوثيقة 06): P-108
تتطلب تسجيل الدخول
عند النجاح: 200

حقول الطلب
الحقل	النوع	إلزامي
`approve`	`boolean`	نعم

أشخاص ومنظمات قد تكون مكرّرة

GET /api/v1/staff/duplicates

الصلاحية (الوثيقة 06): P-704
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

دمج تكرار محتمل أو استبعاده

POST /api/v1/staff/duplicates/decisions

الصلاحية (الوثيقة 06): P-704
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`kind`	`person \| organization`	نعم
`kept_id`	`string (uuid)`	نعم
`other_id`	`string (uuid)`	نعم
`decision`	`merged \| dismissed`	نعم

المنظمات بانتظار الموافقة

GET /api/v1/staff/organizations

الصلاحية (الوثيقة 06): P-108
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

الموافقة على منظمة أو رفضها أو تعليقها أو إغلاقها

POST /api/v1/staff/organizations/{org_id}/decision

الصلاحية (الوثيقة 06): P-108
تتطلب تسجيل الدخول
عند النجاح: 200

حقول الطلب
الحقل	النوع	إلزامي
`decision`	`approve \| reject \| request_info \| suspend \| close`	نعم
`reason`	`string`	لا
`record_types`	`qualification \| certificate \| training \| experience \| membership \| license[]`	لا

قائمة انتظار الاسترداد اليدوي

GET /api/v1/staff/recovery-cases

الصلاحية (الوثيقة 06): P-111
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

الموافقة على استرداد يدوي أو رفضه

POST /api/v1/staff/recovery-cases/{case_id}/decision

الصلاحية (الوثيقة 06): P-111
تتطلب تسجيل الدخول
عند النجاح: 204

حقول الطلب
الحقل	النوع	إلزامي
`approve`	`boolean`	نعم
`reason`	`string`	نعم

الأدوار الداخلية ومن يحملها

GET /api/v1/staff/role-grants

الصلاحية (الوثيقة 06): P-109
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

منح دور داخلي

POST /api/v1/staff/role-grants

الصلاحية (الوثيقة 06): P-109
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`phone_e164`	`string`	نعم
`role`	`administrator \| content_editor \| curator \| expert_reviewer \| moderator`	نعم

سحب دور داخلي

DELETE /api/v1/staff/role-grants/{grant_id}

الصلاحية (الوثيقة 06): P-109
تتطلب تسجيل الدخول
عند النجاح: 204

لا تحتاج إلى محتوى في الطلب (body).

applications

تأكيد التوظيف؛ تُضاف الوظيفة إلى الجواز بمستوى L2

POST /api/v1/applications/{app_id}/hire-confirmation

الصلاحية (الوثيقة 06): P-308
تتطلب تسجيل الدخول
عند النجاح: 201

لا تحتاج إلى محتوى في الطلب (body).

catalog

المجموعات المختارة، ومنها المسودات

GET /api/v1/catalog/collections

الصلاحية (الوثيقة 06): P-504
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

إنشاء مجموعة مختارة

POST /api/v1/catalog/collections

الصلاحية (الوثيقة 06): P-504
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`title_ar`	`string`	نعم
`title_en`	`string`	نعم
`source_note`	`string`	نعم
`course_ids`	`string (uuid)[]`	لا
`publish`	`boolean`	لا

تعديل مجموعة مختارة أو نشرها

PATCH /api/v1/catalog/collections/{collection_id}

الصلاحية (الوثيقة 06): P-504
تتطلب تسجيل الدخول
عند النجاح: 200

حقول الطلب
الحقل	النوع	إلزامي
`title_ar`	`string`	لا
`title_en`	`string`	لا
`source_note`	`string`	لا
`course_ids`	`string (uuid)[]`	لا
`publish`	`boolean`	لا

دورات الدليل بكل حالاتها

GET /api/v1/catalog/courses

الصلاحية (الوثيقة 06): P-504
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

إضافة دورة إلى الدليل

POST /api/v1/catalog/courses

الصلاحية (الوثيقة 06): P-504
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`provider_id`	`string (uuid)`	لا
`provider_course_id`	`string`	لا
`title`	`string`	نعم
`language`	`ar \| en`	نعم
`delivery_mode`	`self_paced \| live_online \| in_person`	نعم
`fee_type`	`free \| paid \| subsidized \| grant_eligible`	نعم
`fee_amount`	`string \| null (decimal)`	لا
`duration_hours`	`string \| null (decimal)`	لا
`gives_certificate`	`boolean`	لا
`enrollment_url`	`string \| null`	لا
`skill_codes`	`string[]`	لا
`status`	`imported \| published \| needs_update \| expired \| archived`	لا
`confirm`	`boolean`	لا

دورة واحدة من الدليل

GET /api/v1/catalog/courses/{course_id}

الصلاحية (الوثيقة 06): P-504
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

تعديل دورة

PATCH /api/v1/catalog/courses/{course_id}

الصلاحية (الوثيقة 06): P-504
تتطلب تسجيل الدخول
عند النجاح: 200

حقول الطلب
الحقل	النوع	إلزامي
`provider_id`	`string (uuid)`	لا
`provider_course_id`	`string`	لا
`title`	`string`	لا
`language`	`ar \| en`	لا
`delivery_mode`	`self_paced \| live_online \| in_person`	لا
`fee_type`	`free \| paid \| subsidized \| grant_eligible`	لا
`fee_amount`	`string \| null (decimal)`	لا
`duration_hours`	`string \| null (decimal)`	لا
`gives_certificate`	`boolean`	لا
`enrollment_url`	`string \| null`	لا
`skill_codes`	`string[]`	لا
`status`	`imported \| published \| needs_update \| expired \| archived`	لا
`confirm`	`boolean`	لا

استيراد ملف دورات جهة

POST /api/v1/catalog/imports

الصلاحية (الوثيقة 06): P-504
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`provider_id`	`string (uuid)`	نعم
`file`	`string (uri)`	نعم

ملف دورات بعد فحصه

GET /api/v1/catalog/imports/{import_id}

الصلاحية (الوثيقة 06): P-504
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

استيراد الصفوف السليمة من ملف مفحوص

POST /api/v1/catalog/imports/{import_id}/confirmation

الصلاحية (الوثيقة 06): P-504
تتطلب تسجيل الدخول
عند النجاح: 201

لا تحتاج إلى محتوى في الطلب (body).

تقرير أخطاء ملف الدورات (CSV)

GET /api/v1/catalog/imports/{import_id}/report

الصلاحية (الوثيقة 06): P-504
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

جهات تقديم الدورات

GET /api/v1/catalog/providers

الصلاحية (الوثيقة 06): P-504
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

إضافة جهة تقديم دورات

POST /api/v1/catalog/providers

الصلاحية (الوثيقة 06): P-504
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`name`	`string`	نعم
`accreditation_status`	`string`	لا
`website`	`object`	لا
`phone`	`string`	لا

مزامنة دورات الجهة عبر واجهتها البرمجية

POST /api/v1/catalog/providers/{provider_id}/sync

الصلاحية (الوثيقة 06): P-504
تتطلب تسجيل الدخول
عند النجاح: 202

لا تحتاج إلى محتوى في الطلب (body).

collections

المجموعات المختارة المنشورة

GET /api/v1/collections

الصلاحية (الوثيقة 06): P-502
متاحة دون تسجيل دخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

مجموعة مختارة منشورة واحدة

GET /api/v1/collections/{collection_id}

الصلاحية (الوثيقة 06): P-502
متاحة دون تسجيل دخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

contracts

عقد واحد بمراحله وتسليماته وتاريخه

GET /api/v1/contracts/{contract_id}

الصلاحية (الوثيقة 06): P-404
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

تعديل العقد؛ ويؤكّده الطرف الآخر مجدداً

PATCH /api/v1/contracts/{contract_id}

الصلاحية (الوثيقة 06): P-404
تتطلب تسجيل الدخول
عند النجاح: 200

حقول الطلب
الحقل	النوع	إلزامي
`scope`	`string`	لا
`price`	`string (decimal)`	لا
`currency`	`SYP \| USD`	لا
`milestones`	`object[]`	لا

تأكيد عقد (يسري حين يؤكّده الطرفان)

POST /api/v1/contracts/{contract_id}/confirmation

الصلاحية (الوثيقة 06): P-404
تتطلب تسجيل الدخول
عند النجاح: 201

لا تحتاج إلى محتوى في الطلب (body).

فتح نزاع

POST /api/v1/contracts/{contract_id}/disputes

الصلاحية (الوثيقة 06): P-406
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`statement`	`string`	نعم
`evidence_file_id`	`string \| null (uuid)`	لا

تسليم مرحلة

POST /api/v1/contracts/{contract_id}/milestones/{milestone_id}/deliveries

الصلاحية (الوثيقة 06): P-404
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`note`	`string`	لا
`file_id`	`string \| null (uuid)`	لا

قبول تسليم أو إعادته

POST /api/v1/contracts/{contract_id}/milestones/{milestone_id}/review

الصلاحية (الوثيقة 06): P-404
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`result`	`accepted \| changes_requested`	نعم
`comment`	`string`	لا

تقييم الطرف الآخر بعد الإنجاز

POST /api/v1/contracts/{contract_id}/ratings

الصلاحية (الوثيقة 06): P-406
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`stars`	`integer`	نعم
`comment`	`string`	لا

conversations

محادثاتي

GET /api/v1/conversations

الصلاحية (الوثيقة 06): P-405
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

بدء محادثة عقد أو طلب توظيف أو عرض

POST /api/v1/conversations

الصلاحية (الوثيقة 06): P-405
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`context_type`	`contract \| application \| offer`	نعم
`context_id`	`string (uuid)`	نعم

محادثة واحدة مع رسائلها

GET /api/v1/conversations/{conversation_id}

الصلاحية (الوثيقة 06): P-405
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

إرسال رسالة

POST /api/v1/conversations/{conversation_id}/messages

الصلاحية (الوثيقة 06): P-405
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`body`	`string`	نعم

courses

البحث في دليل الدورات

GET /api/v1/courses

الصلاحية (الوثيقة 06): P-502
متاحة دون تسجيل دخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

دورة واحدة مع مواعيدها ومصدرها

GET /api/v1/courses/{course_id}

الصلاحية (الوثيقة 06): P-502
متاحة دون تسجيل دخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

احتساب زيارة الجهة أو سؤالها أو الحفظ

POST /api/v1/courses/{course_id}/actions

الصلاحية (الوثيقة 06): P-502
متاحة دون تسجيل دخول
عند النجاح: 202

حقول الطلب
الحقل	النوع	إلزامي
`action`	`provider \| enquiry \| save`	نعم

مقارنة حتى 4 دورات

GET /api/v1/courses/comparison

الصلاحية (الوثيقة 06): P-502
متاحة دون تسجيل دخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

M2 جواز المهارات والتوثيق

من اطّلع على ملفي

GET /api/v1/me/access-log

الصلاحية (الوثيقة 06): P-207
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

إنشاء سيرة ذاتية من الجواز (PDF بالعربية أو الإنجليزية)

POST /api/v1/me/cv

الصلاحية (الوثيقة 06): P-205
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`language`	`ar \| en`	نعم
`template`	`classic \| band`	نعم
`sections`	`qualification \| certificate \| training \| experience \| skill \| language \| project \| volunteering \| membership \| license[]`	نعم
`exclude`	`string (uuid)[]`	لا
`phone`	`boolean`	لا
`city`	`boolean`	لا

استيراد سجلاتي التعليمية بعد الموافقة

POST /api/v1/me/education-imports

الصلاحية (الوثيقة 06): P-203
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`ministry`	`moe \| mohe`	نعم

حالة الاستيراد

GET /api/v1/me/education-imports/{import_id}

الصلاحية (الوثيقة 06): P-203
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

إبقاء السجلات التعليمية المستوردة أو استبعادها

POST /api/v1/me/education-imports/{import_id}/confirmation

الصلاحية (الوثيقة 06): P-203
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`keep`	`integer[]`	نعم

اقتراح جهة إصدار غير موجودة على المنصة

POST /api/v1/me/issuer-suggestions

الصلاحية (الوثيقة 06): P-202
تتطلب تسجيل الدخول
عند النجاح: 202

حقول الطلب
الحقل	النوع	إلزامي
`name`	`string`	نعم
`section`	`qualification \| certificate \| training \| experience \| skill \| language \| project \| volunteering \| membership \| license`	نعم

جوازي بكل سجلاته

GET /api/v1/me/passport

الصلاحية (الوثيقة 06): P-201
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

إضافة سجل

POST /api/v1/me/passport/entries

الصلاحية (الوثيقة 06): P-201
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`occupation_code`	`string \| null`	لا
`file_ids`	`string (uuid)[]`	لا
`section`	`qualification \| certificate \| training \| experience \| skill \| language \| project \| volunteering \| membership \| license`	نعم
`data`	`object`	نعم

تعديل سجل (يصبح السجل الموثّق L2 نسخة جديدة L0)

PATCH /api/v1/me/passport/entries/{entry_id}

الصلاحية (الوثيقة 06): P-201
تتطلب تسجيل الدخول
عند النجاح: 200

حقول الطلب
الحقل	النوع	إلزامي
`occupation_code`	`string \| null`	لا
`file_ids`	`string (uuid)[]`	لا
`data`	`object`	لا

حذف سجل غير موثّق

DELETE /api/v1/me/passport/entries/{entry_id}

الصلاحية (الوثيقة 06): P-201
تتطلب تسجيل الدخول
عند النجاح: 204

لا تحتاج إلى محتوى في الطلب (body).

الاعتراض أو طلب تصحيح سجل موثّق

POST /api/v1/me/passport/entries/{entry_id}/disputes

الصلاحية (الوثيقة 06): P-208
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`reason`	`string`	نعم
`evidence_file_id`	`string \| null (uuid)`	لا

الجهات التي يمكنها توثيق السجل، وما ستطّلع عليه

GET /api/v1/me/passport/entries/{entry_id}/verification-requests

الصلاحية (الوثيقة 06): P-202
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

طلب توثيق سجل من جهة إصدار

POST /api/v1/me/passport/entries/{entry_id}/verification-requests

الصلاحية (الوثيقة 06): P-202
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`issuer_org_id`	`string (uuid)`	نعم

ظهور الأقسام والحقول

GET /api/v1/me/passport/visibility

الصلاحية (الوثيقة 06): P-204
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

ضبط ظهور الأقسام والحقول

PUT /api/v1/me/passport/visibility

الصلاحية (الوثيقة 06): P-204
تتطلب تسجيل الدخول
عند النجاح: 200

حقول الطلب
الحقل	النوع	إلزامي
`sections`	`object`	لا
`fields`	`object`	لا

الجواز كما يراه العموم أو صاحب العمل

GET /api/v1/me/passport/visibility/preview

الصلاحية (الوثيقة 06): P-204
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

سجلات رفعتها جهة إصدار باسمي

GET /api/v1/me/pending-claims

الصلاحية (الوثيقة 06): P-201
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

قبول سجل معلّق أو رفضه

POST /api/v1/me/pending-claims/{claim_id}/decision

الصلاحية (الوثيقة 06): P-201
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`accept`	`boolean`	نعم

رابط المشاركة برمز QR الساري

GET /api/v1/me/share-links

الصلاحية (الوثيقة 06): P-205
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

إنشاء رابط مشاركة برمز QR

POST /api/v1/me/share-links

الصلاحية (الوثيقة 06): P-205
تتطلب تسجيل الدخول
عند النجاح: 201

لا تحتاج إلى محتوى في الطلب (body).

إلغاء رابط مشاركة برمز QR

DELETE /api/v1/me/share-links/{link_id}

الصلاحية (الوثيقة 06): P-205
تتطلب تسجيل الدخول
عند النجاح: 204

لا تحتاج إلى محتوى في الطلب (body).

سجل نشاطي

GET /api/v1/me/work-log

الصلاحية (الوثيقة 06): P-207
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

رفع ملف CSV بسجلات موثّقة

POST /api/v1/organizations/{org_id}/bulk-verifications

الصلاحية (الوثيقة 06): P-210
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`file`	`string (uri)`	نعم
`record_type`	`qualification \| certificate \| training \| experience \| skill \| language \| project \| volunteering \| membership \| license`	نعم

حالة الدفعة وأعدادها

GET /api/v1/organizations/{org_id}/bulk-verifications/{batch_id}

الصلاحية (الوثيقة 06): P-210
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

تأكيد استيراد ملف تم فحصه

POST /api/v1/organizations/{org_id}/bulk-verifications/{batch_id}/confirmation

الصلاحية (الوثيقة 06): P-210
تتطلب تسجيل الدخول
عند النجاح: 202

لا تحتاج إلى محتوى في الطلب (body).

أخطاء الصفوف بصيغة CSV

GET /api/v1/organizations/{org_id}/bulk-verifications/{batch_id}/errors

الصلاحية (الوثيقة 06): P-210
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

قائمة الاعتراضات لدى جهة الإصدار

GET /api/v1/organizations/{org_id}/disputes

الصلاحية (الوثيقة 06): P-211
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

اعتراض واحد مع السجل وتاريخه

GET /api/v1/organizations/{org_id}/disputes/{dispute_id}

الصلاحية (الوثيقة 06): P-211
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

البتّ في اعتراض؛ تصحيح سجل أو سحب توثيقه

POST /api/v1/organizations/{org_id}/disputes/{dispute_id}/decision

الصلاحية (الوثيقة 06): P-211
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`outcome`	`verify \| uphold \| revoke`	نعم
`method`	`registry_check \| original_document \| direct_confirmation`	لا
`note`	`string`	لا
`data`	`object`	لا

قائمة طلبات التوثيق لدى جهة الإصدار

GET /api/v1/organizations/{org_id}/verification-requests

الصلاحية (الوثيقة 06): P-209
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

طلب واحد مع البيانات المشاركة

GET /api/v1/organizations/{org_id}/verification-requests/{request_id}

الصلاحية (الوثيقة 06): P-209
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

قبول طلب توثيق أو رفضه

POST /api/v1/organizations/{org_id}/verification-requests/{request_id}/decision

الصلاحية (الوثيقة 06): P-209
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`decision`	`accept \| reject`	نعم
`method`	`registry_check \| original_document \| direct_confirmation`	لا
`reason`	`not_found \| data_mismatch \| not_genuine \| other`	لا
`note`	`string`	لا
`valid_until`	`string (date)`	لا

السجلات التي وثّقتها جهة الإصدار، بالبحث باسم صاحبها

GET /api/v1/organizations/{org_id}/verified-records

الصلاحية (الوثيقة 06): P-211
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

سحب توثيق سجل وثّقته جهة الإصدار

POST /api/v1/organizations/{org_id}/verified-records/{entry_id}/revocation

الصلاحية (الوثيقة 06): P-211
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`reason`	`string`	نعم

فتح جواز مُشارَك برمز QR

GET /api/v1/shared/{token}

الصلاحية (الوثيقة 06): P-206
متاحة دون تسجيل دخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

me

طلباتي وحالاتها

GET /api/v1/me/applications

الصلاحية (الوثيقة 06): P-303
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

طلب واحد مع تاريخه

GET /api/v1/me/applications/{app_id}

الصلاحية (الوثيقة 06): P-303
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

سحب طلب

POST /api/v1/me/applications/{app_id}/withdrawal

الصلاحية (الوثيقة 06): P-303
تتطلب تسجيل الدخول
عند النجاح: 201

لا تحتاج إلى محتوى في الطلب (body).

حظر حساب

POST /api/v1/me/blocks

الصلاحية (الوثيقة 06): P-405
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`account_id`	`string (uuid)`	نعم

إلغاء حظر حساب

DELETE /api/v1/me/blocks/{account_id}

الصلاحية (الوثيقة 06): P-405
تتطلب تسجيل الدخول
عند النجاح: 204

لا تحتاج إلى محتوى في الطلب (body).

تحديد الأهداف المهنية

PUT /api/v1/me/career-goals

الصلاحية (الوثيقة 06): P-501
تتطلب تسجيل الدخول
عند النجاح: 200

حقول الطلب
الحقل	النوع	إلزامي
`occupation_code`	`string \| null`	نعم

العقود الخاصة، بصفة عميل أو مستقل

GET /api/v1/me/contracts

الصلاحية (الوثيقة 06): P-404
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

استبيان الاهتمامات والإجابات حتى الآن والهدف

GET /api/v1/me/interest-profile

الصلاحية (الوثيقة 06): P-501
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

حفظ استبيان الاهتمامات

PUT /api/v1/me/interest-profile

الصلاحية (الوثيقة 06): P-501
تتطلب تسجيل الدخول
عند النجاح: 200

حقول الطلب
الحقل	النوع	إلزامي
`answers`	`object`	لا
`personalization_on`	`boolean \| null`	لا

تأكيد المقابلة أو طلب موعد آخر

POST /api/v1/me/interviews/{interview_id}/answer

الصلاحية (الوثيقة 06): P-303
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`confirm`	`boolean`	نعم
`note`	`string`	لا

مساراتي التعليمية

GET /api/v1/me/learning-paths

الصلاحية (الوثيقة 06): P-503
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

بناء مسار تعليمي للهدف المهني

POST /api/v1/me/learning-paths

الصلاحية (الوثيقة 06): P-503
تتطلب تسجيل الدخول
عند النجاح: 201

لا تحتاج إلى محتوى في الطلب (body).

تحديث التقدّم في خطوة

PATCH /api/v1/me/learning-paths/{path_id}/activities/{step_id}

الصلاحية (الوثيقة 06): P-503
تتطلب تسجيل الدخول
عند النجاح: 200

حقول الطلب
الحقل	النوع	إلزامي
`status`	`todo \| in_progress \| attended \| skipped \| mastered`	لا

طلبات الإرشاد التي أرسلتها وتلقيتها

GET /api/v1/me/mentoring-requests

الصلاحية (الوثيقة 06): P-601
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

القضايا المتعلقة بحسابي أو بفرص منظمتي

GET /api/v1/me/moderation-cases

الصلاحية (الوثيقة 06): P-102
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

قضية واحدة كما يراها الطرف المُبلَّغ عنه

GET /api/v1/me/moderation-cases/{case_id}

الصلاحية (الوثيقة 06): P-102
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

القناة والتكرار لكل فئة

GET /api/v1/me/notification-preferences

الصلاحية (الوثيقة 06): P-705
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

تغيير القناة والتكرار (يبقى الأمان مفعّلاً)

PUT /api/v1/me/notification-preferences

الصلاحية (الوثيقة 06): P-705
تتطلب تسجيل الدخول
عند النجاح: 200

حقول الطلب
الحقل	النوع	إلزامي
`preferences`	`object[]`	نعم

قائمة الإشعارات في المنصة

GET /api/v1/me/notifications

الصلاحية (الوثيقة 06): P-705
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

تعليم إشعار مقروءاً

POST /api/v1/me/notifications/{notification_id}/read

الصلاحية (الوثيقة 06): P-705
تتطلب تسجيل الدخول
عند النجاح: 201

لا تحتاج إلى محتوى في الطلب (body).

العروض الخاصة وما آلت إليه

GET /api/v1/me/offers

الصلاحية (الوثيقة 06): P-403
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

دعوات التقديم التي وصلتني

GET /api/v1/me/opportunity-invitations

الصلاحية (الوثيقة 06): P-303
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

قبول دعوة إلى التقديم أو رفضها

POST /api/v1/me/opportunity-invitations/{invitation_id}/decision

الصلاحية (الوثيقة 06): P-303
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`accept`	`boolean`	نعم

التوصيات المهنية وفجوات المهارات مع شرحها

GET /api/v1/me/recommendations

الصلاحية (الوثيقة 06): P-501
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

تقييم توصية بأنها مفيدة أو غير مفيدة

POST /api/v1/me/recommendations/{rec_id}/feedback

الصلاحية (الوثيقة 06): P-501
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`useful`	`boolean`	نعم
`comment`	`string`	لا

الفرص والدورات المحفوظة

GET /api/v1/me/saved-items

الصلاحية (الوثيقة 06): P-302
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

حفظ فرصة أو دورة

POST /api/v1/me/saved-items

الصلاحية (الوثيقة 06): P-302
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`item_type`	`opportunity \| course`	نعم
`item_id`	`string (uuid)`	نعم

إزالة عنصر محفوظ

DELETE /api/v1/me/saved-items/{item_id}

الصلاحية (الوثيقة 06): P-302
تتطلب تسجيل الدخول
عند النجاح: 204

لا تحتاج إلى محتوى في الطلب (body).

عرض تنبيهات البحث

GET /api/v1/me/search-alerts

الصلاحية (الوثيقة 06): P-302
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

إنشاء تنبيه بحث

POST /api/v1/me/search-alerts

الصلاحية (الوثيقة 06): P-302
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`query`	`object`	نعم

حذف تنبيه بحث

DELETE /api/v1/me/search-alerts/{alert_id}

الصلاحية (الوثيقة 06): P-302
تتطلب تسجيل الدخول
عند النجاح: 204

لا تحتاج إلى محتوى في الطلب (body).

بطاقة الخدمات الخاصة والمشاريع التي يمكن أن تعرضها

GET /api/v1/me/service-card

الصلاحية (الوثيقة 06): P-401
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

نشر بطاقة الخدمات الخاصة أو تعديلها

PUT /api/v1/me/service-card

الصلاحية (الوثيقة 06): P-401
تتطلب تسجيل الدخول
عند النجاح: 200

حقول الطلب
الحقل	النوع	إلزامي
`title`	`string`	نعم
`category`	`design \| translation \| software \| engineering \| accounting \| teaching \| construction \| marketing \| writing \| other`	نعم
`price_min`	`string \| null (decimal)`	لا
`price_max`	`string \| null (decimal)`	لا
`currency`	`SYP \| USD`	لا
`delivery_days`	`integer \| null`	لا
`status`	`published \| hidden`	لا
`portfolio`	`string (uuid)[]`	لا

mentoring-requests

طلب إرشاد

POST /api/v1/mentoring-requests

الصلاحية (الوثيقة 06): P-601
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`mentor_id`	`string (uuid)`	نعم
`goal`	`string`	نعم
`time_zone`	`string`	نعم

تأكيد انعقاد جلسة الإرشاد

POST /api/v1/mentoring-requests/{request_id}/confirmation

الصلاحية (الوثيقة 06): P-601
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`add_to_work_log`	`boolean`	لا

قبول الإرشاد أو الاعتذار عنه أو إتمامه

POST /api/v1/mentoring-requests/{request_id}/decision

الصلاحية (الوثيقة 06): P-602
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`decision`	`accept \| decline \| complete`	نعم
`session_at`	`string (date-time)`	لا
`time_zone`	`string`	لا
`meeting_details`	`string`	لا
`add_to_work_log`	`boolean`	لا

moderation-cases

الاعتراض على قرار المراجعة

POST /api/v1/moderation-cases/{case_id}/appeals

الصلاحية (الوثيقة 06): P-102
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`reason`	`string`	نعم

offers

قبول عرض؛ وتُرفض العروض الأخرى

POST /api/v1/offers/{offer_id}/acceptance

الصلاحية (الوثيقة 06): P-404
تتطلب تسجيل الدخول
عند النجاح: 201

لا تحتاج إلى محتوى في الطلب (body).

opportunities

البحث في الفرص المنشورة

GET /api/v1/opportunities

الصلاحية (الوثيقة 06): P-301
متاحة دون تسجيل دخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

فرصة منشورة

GET /api/v1/opportunities/{opp_id}

الصلاحية (الوثيقة 06): P-301
متاحة دون تسجيل دخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

ما يُشارك عند التقدّم، وما لا يظهر في الجواز

GET /api/v1/opportunities/{opp_id}/application-preview

الصلاحية (الوثيقة 06): P-303
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

التقدّم مع الإجابات والملفات

POST /api/v1/opportunities/{opp_id}/applications

الصلاحية (الوثيقة 06): P-303
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`message`	`string`	لا
`answers`	`object`	لا
`file_ids`	`string (uuid)[]`	لا

organizations

طلب واحد مع جواز المرشّح كما يراه صاحب العمل

GET /api/v1/organizations/{org_id}/applications/{app_id}

الصلاحية (الوثيقة 06): P-305
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

تحديد موعد مقابلة

POST /api/v1/organizations/{org_id}/applications/{app_id}/interviews

الصلاحية (الوثيقة 06): P-306
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`scheduled_at`	`string (date-time)`	نعم
`time_zone`	`string`	نعم
`mode`	`in_person \| phone \| online`	نعم
`location_or_link`	`string \| null`	لا

نقل المرشّح إلى المرحلة التالية

POST /api/v1/organizations/{org_id}/applications/{app_id}/transitions

الصلاحية (الوثيقة 06): P-305
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`action`	`shortlist \| interview \| offer \| hire \| reject`	نعم
`reason`	`string`	لا

تغيير موعد المقابلة أو إلغاؤها

PATCH /api/v1/organizations/{org_id}/interviews/{interview_id}

الصلاحية (الوثيقة 06): P-306
تتطلب تسجيل الدخول
عند النجاح: 200

حقول الطلب
الحقل	النوع	إلزامي
`action`	`reschedule \| cancel`	لا
`scheduled_at`	`string (date-time)`	لا
`time_zone`	`string`	لا
`mode`	`in_person \| phone \| online`	لا
`location_or_link`	`string \| null`	لا
`reason`	`string`	لا

الدعوات المرسلة وردودها

GET /api/v1/organizations/{org_id}/invitations

الصلاحية (الوثيقة 06): P-307
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

دعوة شخص إلى التقديم

POST /api/v1/organizations/{org_id}/invitations

الصلاحية (الوثيقة 06): P-307
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`opportunity_id`	`string (uuid)`	نعم
`person_id`	`string (uuid)`	نعم

فرص المنظمة

GET /api/v1/organizations/{org_id}/opportunities

الصلاحية (الوثيقة 06): P-304
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

إنشاء فرصة (مسودة)

POST /api/v1/organizations/{org_id}/opportunities

الصلاحية (الوثيقة 06): P-304
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`opp_type`	`job \| internship \| training \| scholarship \| grant \| volunteering`	نعم
`title`	`string`	نعم
`description`	`string`	لا
`occupation_code`	`string \| null`	لا
`min_experience_years`	`integer \| null`	لا
`education_level`	`object`	لا
`languages`	`object[]`	لا
`governorate_code`	`string \| null`	لا
`is_remote`	`boolean`	لا
`open_abroad`	`boolean`	لا
`remote_from_abroad`	`boolean`	لا
`tags`	`women_focused \| home_based \| flexible_hours \| digital[]`	لا
`deadline`	`string (date)`	لا
`eligibility`	`string`	لا
`type_details`	`object \| null`	لا
`skills`	`object[]`	لا
`questions`	`object[]`	لا

فرصة من فرص المنظمة

GET /api/v1/organizations/{org_id}/opportunities/{opp_id}

الصلاحية (الوثيقة 06): P-304
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

تعديل فرصة

PATCH /api/v1/organizations/{org_id}/opportunities/{opp_id}

الصلاحية (الوثيقة 06): P-304
تتطلب تسجيل الدخول
عند النجاح: 200

حقول الطلب
الحقل	النوع	إلزامي
`opp_type`	`job \| internship \| training \| scholarship \| grant \| volunteering`	لا
`title`	`string`	لا
`description`	`string`	لا
`occupation_code`	`string \| null`	لا
`min_experience_years`	`integer \| null`	لا
`education_level`	`object`	لا
`languages`	`object[]`	لا
`governorate_code`	`string \| null`	لا
`is_remote`	`boolean`	لا
`open_abroad`	`boolean`	لا
`remote_from_abroad`	`boolean`	لا
`tags`	`women_focused \| home_based \| flexible_hours \| digital[]`	لا
`deadline`	`string (date)`	لا
`eligibility`	`string`	لا
`type_details`	`object \| null`	لا
`skills`	`object[]`	لا
`questions`	`object[]`	لا

الطلبات المقدّمة إلى فرصة

GET /api/v1/organizations/{org_id}/opportunities/{opp_id}/applications

الصلاحية (الوثيقة 06): P-305
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

نسخ فرصة

POST /api/v1/organizations/{org_id}/opportunities/{opp_id}/copies

الصلاحية (الوثيقة 06): P-304
تتطلب تسجيل الدخول
عند النجاح: 201

لا تحتاج إلى محتوى في الطلب (body).

النشر أو الإيقاف المؤقت أو الإغلاق أو إعادة الفتح

POST /api/v1/organizations/{org_id}/opportunities/{opp_id}/transitions

الصلاحية (الوثيقة 06): P-304
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`action`	`publish \| pause \| close`	نعم

البحث في سجل خبراء إعادة الإعمار (تُسجَّل عمليات البحث)

GET /api/v1/organizations/{org_id}/reconstruction-experts

الصلاحية (الوثيقة 06): P-604
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

خبير من السجل كما يراه أصحاب العمل (يُسجَّل الاطلاع)

GET /api/v1/organizations/{org_id}/reconstruction-experts/{person_id}

الصلاحية (الوثيقة 06): P-604
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

عدد المهنيين الموثَّقين بحسب المهنة والمحافظة

GET /api/v1/organizations/{org_id}/reconstruction-supply

الصلاحية (الوثيقة 06): P-604
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

البحث في الأشخاص القابلين للاكتشاف (تُسجَّل عمليات البحث)

GET /api/v1/organizations/{org_id}/talent

الصلاحية (الوثيقة 06): P-307
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

جواز شخص قابل للاكتشاف كما يراه أصحاب العمل (يُسجَّل الاطلاع)

GET /api/v1/organizations/{org_id}/talent/{person_id}

الصلاحية (الوثيقة 06): P-307
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

reports

الإبلاغ عن فرصة أو حساب أو رسالة

POST /api/v1/reports

الصلاحية (الوثيقة 06): P-309
متاحة دون تسجيل دخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`target_type`	`opportunity \| account \| rating \| message`	نعم
`target_id`	`string (uuid)`	نعم
`reason`	`fraud \| discrimination \| misleading \| abuse \| other`	نعم
`details`	`string`	لا
`evidence_file_id`	`string \| null (uuid)`	لا

service-cards

البحث في بطاقات خدمات المستقلين

GET /api/v1/service-cards

الصلاحية (الوثيقة 06): P-301
متاحة دون تسجيل دخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

staff

البتّ في اعتراض (مشرف آخر)

POST /api/v1/staff/appeals/{appeal_id}/decision

الصلاحية (الوثيقة 06): P-702
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`action`	`remove \| restore \| suspend \| warn`	نعم
`reason`	`string`	نعم

الفروق بين الفئات التي وجدها تدقيق العدالة

GET /api/v1/staff/fairness-reviews

الصلاحية (الوثيقة 06): P-906
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

تسجيل المراجعة البشرية لنتيجة تدقيق العدالة

POST /api/v1/staff/fairness-reviews/{review_id}/decision

الصلاحية (الوثيقة 06): P-906
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`outcome`	`justified \| action_taken`	نعم
`note`	`string`	نعم

نزاعات العمل الحر المفتوحة والمعترَض على قراراتها

GET /api/v1/staff/freelance-disputes

الصلاحية (الوثيقة 06): P-407
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

نزاع واحد مع العقد والرسائل والإفادات

GET /api/v1/staff/freelance-disputes/{dispute_id}

الصلاحية (الوثيقة 06): P-407
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

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

POST /api/v1/staff/freelance-disputes/{dispute_id}/decision

الصلاحية (الوثيقة 06): P-407
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`action`	`restore \| close_contract \| remove_rating \| warn \| suspend`	نعم
`facts`	`string`	نعم
`reason`	`string`	نعم
`party`	`object`	لا
`rating_id`	`string \| null (uuid)`	لا

تصعيد اتصال فاشل إلى الجهة المسؤولة

POST /api/v1/staff/integration-calls/{call_id}/escalation

الصلاحية (الوثيقة 06): P-706
تتطلب تسجيل الدخول
عند النجاح: 201

لا تحتاج إلى محتوى في الطلب (body).

إعادة محاولة اتصال فاشل بالمفتاح نفسه

POST /api/v1/staff/integration-calls/{call_id}/retry

الصلاحية (الوثيقة 06): P-706
تتطلب تسجيل الدخول
عند النجاح: 201

لا تحتاج إلى محتوى في الطلب (body).

حالة كل تكامل

GET /api/v1/staff/integrations

الصلاحية (الوثيقة 06): P-706
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

قائمة البلاغات للمراجعة

GET /api/v1/staff/moderation-cases

الصلاحية (الوثيقة 06): P-701
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

قضية مراجعة واحدة مع بلاغاتها وأدلتها

GET /api/v1/staff/moderation-cases/{case_id}

الصلاحية (الوثيقة 06): P-701
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

الإخفاء أو الإعادة أو الإزالة أو الإنذار أو التعليق

POST /api/v1/staff/moderation-cases/{case_id}/decisions

الصلاحية (الوثيقة 06): P-701
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`action`	`remove \| restore \| suspend \| warn`	نعم
`reason`	`string`	نعم

سجل الحقول الحساسة

GET /api/v1/staff/sensitive-fields

الصلاحية (الوثيقة 06): P-704
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

مراجعة حقل حساس

POST /api/v1/staff/sensitive-fields/{field_key}/review

الصلاحية (الوثيقة 06): P-704
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`purpose_ar`	`string`	لا
`purpose_en`	`string`	لا
`access_roles`	`string[]`	لا
`optional`	`boolean`	لا
`review_months`	`integer`	لا

إضافة المصطلحات أو ربطها أو دمجها أو تقسيمها أو إعادة تسميتها (إصدار جديد)

POST /api/v1/staff/taxonomy/changes

الصلاحية (الوثيقة 06): P-704
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`notes`	`string`	لا
`changes`	`object[]`	نعم

المصطلحات المقترحة بانتظار المراجعة، وآخر الإصدارات

GET /api/v1/staff/taxonomy/suggestions

الصلاحية (الوثيقة 06): P-704
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

taxonomy

المهن بأسمائها العربية والإنجليزية

GET /api/v1/taxonomy/occupations

الصلاحية (الوثيقة 06): P-301
متاحة دون تسجيل دخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

المهارات مع مرادفاتها

GET /api/v1/taxonomy/skills

الصلاحية (الوثيقة 06): P-301
متاحة دون تسجيل دخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

اقتراح مصطلح جديد لمهارة أو مهنة

POST /api/v1/taxonomy/suggestions

الصلاحية (الوثيقة 06): P-703
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`text`	`string`	نعم
`lang`	`ar \| en`	نعم

women-in-business

محتوى قسم المرأة في الأعمال وفرصه

GET /api/v1/women-in-business

الصلاحية (الوثيقة 06): P-603
متاحة دون تسجيل دخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

work-requests

نشر طلب عمل حر بصفة عميل

POST /api/v1/work-requests

الصلاحية (الوثيقة 06): P-402
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`title`	`string`	نعم
`description`	`string`	نعم
`deliverables`	`string`	نعم
`budget_min`	`integer \| null`	لا
`budget_max`	`integer \| null`	لا
`currency`	`SYP \| USD`	لا
`duration_days`	`integer`	نعم
`deadline`	`string (date)`	نعم
`is_remote`	`boolean`	لا
`governorate_code`	`string \| null`	لا

العروض على طلب العمل الخاص، مع ملف كل مستقل

GET /api/v1/work-requests/{opp_id}/offers

الصلاحية (الوثيقة 06): P-402
تتطلب تسجيل الدخول
عند النجاح: 200

لا تحتاج إلى محتوى في الطلب (body).

إرسال عرض

POST /api/v1/work-requests/{opp_id}/offers

الصلاحية (الوثيقة 06): P-403
تتطلب تسجيل الدخول
عند النجاح: 201

حقول الطلب
الحقل	النوع	إلزامي
`price`	`string (decimal)`	نعم
`currency`	`SYP \| USD`	لا
`timeline_days`	`integer`	نعم
`note`	`string`	لا

الأخطاء

كل خطأ بصيغة problem details (RFC 9457) وبالنوع application/problem+json. ويحمل دائماً هذه الحقول:

status: رمز HTTP
code: رمز ثابت للبرامج، مثل code_invalid
title: عنوان قصير بلغة الطلب
detail: شرح للمستخدم بلغة الطلب (إن وُجد)
request_id: معرّف الطلب، اذكره عند التواصل مع الدعم
errors: أخطاء الحقول: قائمة من field وmessage

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

1.2.0, 3 تشرين الثاني 2026

رموز النجاح تتبع القسم 2.2 من الوثيقة 10: 202 لإرسال رمز ولرفع أدلة الاسترداد، و200 للتحقق من الرمز، و204 لقرار الاسترداد.
أخطاء الحقول قائمة من field وmessage.
هذه الصفحة: كل عملية مع صلاحيتها، بالعربية والإنجليزية.

1.1.0, 3 تشرين الثاني 2026

رموز الأخطاء بأحرف صغيرة؛ وaccount_locked يعيد 429 مع مدة الانتظار بالثواني.
أربع عمليات جديدة: المحافظات، والعامل الثاني، وإعادة التحقق، وتأكيد تطبيق المصادقة.
كل خطأ يحمل request_id.

1.0.0, 29 تشرين الأول 2026

الإصدار الأول المعتمد.