المنصة الوطنية السورية للمهارات والفرص

واجهة البرمجة (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`	نعم

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

POST /api/v1/auth/otp/verify

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

حقول الطلب
الحقل	النوع	إلزامي
`phone_e164`	`string`	نعم
`purpose`	`sign_up \| sign_in \| change_phone \| recovery`	نعم
`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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

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

POST /api/v1/files

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

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

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

GET /api/v1/governorates

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

لا تأخذ جسماً للطلب.

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

GET /api/v1/me

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

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

GET /api/v1/me/diaspora-offer

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

تفعيل تطبيق المصادقة بأول رمز منه؛ ويعيد 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

لا تأخذ جسماً للطلب.

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

DELETE /api/v1/me/sessions

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

لا تأخذ جسماً للطلب.

إنهاء جلسة

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

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

تعديل ملف المنظمة ووثائقها

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

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

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

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

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

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

GET /api/v1/staff/duplicates

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

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

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

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

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

applications

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

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

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

لا تأخذ جسماً للطلب.

catalog

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

GET /api/v1/catalog/collections

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

تعديل دورة

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

لا تأخذ جسماً للطلب.

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

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

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

لا تأخذ جسماً للطلب.

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

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

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

لا تأخذ جسماً للطلب.

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

GET /api/v1/catalog/providers

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

collections

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

GET /api/v1/collections

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

لا تأخذ جسماً للطلب.

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

GET /api/v1/collections/{collection_id}

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

لا تأخذ جسماً للطلب.

contracts

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

GET /api/v1/contracts/{contract_id}

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

فتح نزاع

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

إرسال رسالة

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

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

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

courses

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

GET /api/v1/courses

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

لا تأخذ جسماً للطلب.

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

GET /api/v1/courses/{course_id}

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

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

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

GET /api/v1/me/access-log

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

لا تأخذ جسماً للطلب.

إنشاء سيرة ذاتية من الجواز (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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

إضافة سجل

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

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

GET /api/v1/me/pending-claims

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

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

POST /api/v1/me/share-links

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

لا تأخذ جسماً للطلب.

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

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

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

لا تأخذ جسماً للطلب.

سجل نشاطي

GET /api/v1/me/work-log

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

لا تأخذ جسماً للطلب.

رفع ملف 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

لا تأخذ جسماً للطلب.

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

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

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

لا تأخذ جسماً للطلب.

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

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

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

لا تأخذ جسماً للطلب.

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

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

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

لا تأخذ جسماً للطلب.

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

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

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

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

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

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

me

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

GET /api/v1/me/applications

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

لا تأخذ جسماً للطلب.

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

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

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

لا تأخذ جسماً للطلب.

سحب طلب

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

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

لا تأخذ جسماً للطلب.

حظر حساب

POST /api/v1/me/blocks

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

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

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

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

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

لا تأخذ جسماً للطلب.

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

PUT /api/v1/me/career-goals

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

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

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

GET /api/v1/me/contracts

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

لا تأخذ جسماً للطلب.

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

GET /api/v1/me/interest-profile

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

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

POST /api/v1/me/learning-paths

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

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

GET /api/v1/me/moderation-cases

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

لا تأخذ جسماً للطلب.

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

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

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

لا تأخذ جسماً للطلب.

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

GET /api/v1/me/notification-preferences

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

لا تأخذ جسماً للطلب.

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

PUT /api/v1/me/notification-preferences

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

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

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

GET /api/v1/me/notifications

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

لا تأخذ جسماً للطلب.

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

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

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

لا تأخذ جسماً للطلب.

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

GET /api/v1/me/offers

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

لا تأخذ جسماً للطلب.

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

GET /api/v1/me/opportunity-invitations

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

لا تأخذ جسماً للطلب.

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

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

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

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

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

GET /api/v1/me/recommendations

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

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

GET /api/v1/me/search-alerts

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

لا تأخذ جسماً للطلب.

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

POST /api/v1/me/search-alerts

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

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

حذف تنبيه بحث

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

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

لا تأخذ جسماً للطلب.

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

GET /api/v1/me/service-card

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

opportunities

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

GET /api/v1/opportunities

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

لا تأخذ جسماً للطلب.

فرصة منشورة

GET /api/v1/opportunities/{opp_id}

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

لا تأخذ جسماً للطلب.

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

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

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

تعديل فرصة

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

لا تأخذ جسماً للطلب.

نسخ فرصة

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

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

خبير من السجل كما تراه جهات العمل (مسجَّل)

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

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

لا تأخذ جسماً للطلب.

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

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

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

لا تأخذ جسماً للطلب.

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

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

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

لا تأخذ جسماً للطلب.

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

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

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

لا تأخذ جسماً للطلب.

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

لا تأخذ جسماً للطلب.

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

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

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

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

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

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

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

لا تأخذ جسماً للطلب.

حالة كل تكامل

GET /api/v1/staff/integrations

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

لا تأخذ جسماً للطلب.

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

GET /api/v1/staff/moderation-cases

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

لا تأخذ جسماً للطلب.

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

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

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

taxonomy

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

GET /api/v1/taxonomy/occupations

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

لا تأخذ جسماً للطلب.

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

GET /api/v1/taxonomy/skills

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

لا تأخذ جسماً للطلب.

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

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

لا تأخذ جسماً للطلب.

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

لا تأخذ جسماً للطلب.

إرسال عرض

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

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