JobFlow | API للمطورين

المصادقة

سجل حسابًا، سجل الدخول للحصول على توكن Bearer، وأرفق التوكن في كل طلب يحتاج مصادقة.

POST /api/v1/auth/register
POST /api/v1/auth/login
POST /api/v1/auth/logout (auth required)
GET /api/v1/auth/me (auth required)

يجب تضمين التوكن في الهيدر: Authorization: Bearer {token}

إعلانات الوظائف

ابحث عن الوظائف حسب الفئة والموقع الجغرافي والنطاق. قدّم مباشرة عبر API.

GET /api/v1/jobs ?category=&location=&radius=&page=
GET /api/v1/jobs/{slug}
GET /api/v1/categories
POST /api/v1/jobs/{id}/apply (auth required)

الطلبات

إدارة الطلبات: عرض الحالة، التحديث (الشركات) أو السحب (الباحثون عن عمل).

GET /api/v1/applications (auth required)
GET /api/v1/applications/{id} (auth required)
PUT /api/v1/applications/{id}/status (company only)
POST /api/v1/applications/{id}/withdraw (worker only)

الملفات الشخصية

قراءة وتحديث ملف الباحث عن عمل أو الشركة. الوصول إلى درجة الثقة.

GET /api/v1/profile/worker (auth required)
PUT /api/v1/profile/worker (auth required)
GET /api/v1/profile/company (auth required)
PUT /api/v1/profile/company (auth required)
GET /api/v1/profile/trust-score (auth required)

مثال استخدام

# Login curl -X POST https://jobflow.trovido.com/api/v1/auth/login \ -H "Content-Type: application/json" \ -d '{"email":"user@example.com","password":"secret"}' # Response {"token":"1|abc...","user":{...}} # List jobs (with token) curl https://jobflow.trovido.com/api/v1/jobs?category=chef&page=1 \ -H "Authorization: Bearer 1|abc..."

ملاحظات مهمة

حد المعدل: 60 طلب/دقيقة للمستخدم المصادق، 30/دقيقة للمجهول.
جميع الردود بصيغة JSON. Content-Type: application/json.
القوائم تدعم الترقيم: ?page=1&per_page=15 (حد أقصى 100).
الأخطاء تُرجع برمز HTTP مناسب (401، 403، 404، 422، 429) ونص JSON يحتوي حقل "message".
الوصول لـ API متاح لخطط الأعمال والمميزة. الخطة الأساسية تتيح قراءة الإعلانات العامة فقط.