وظائفك على Jawb، داخل موقع شركتك.
انشر الوظيفة مرة واحدة على Jawb. يمكن لمطور موقعك استخدام تدفق JSON لعرض الوظائف المتاحة في صفحة التوظيف مع رابط التقديم على Jawb.
تجهيز التدفق
أنشئ شركة ظاهرة في «شركاتي» واربط الوظائف بها. لكل شركة تدفق عام للقراءة فقط على /api/entreprises/{identifier}/offres.json. استخدم المعرف الموجود في آخر رابط صفحة الشركة أو UUID. لا تحتاج إلى مفتاح API.
اختيار اللغة والتنقل بين الصفحات
المعاملات: lang بقيم fr أو en أو ar، والافتراضي fr. قيمة limit من 1 إلى 100 والافتراضي 100. يبدأ page من 1. اتبع next حتى يصبح null لجلب كل الصفحات. يتبع title وdescription اللغة المطلوبة مع الرجوع إلى الفرنسية عند غياب الترجمة. تبقى titre وtitre_en وtitre_ar متاحة للتوافق.
فهم البيانات المستلمة
تصف company وcompany_id وcompany_url وwebsite وlogo_url الشركة. تحتوي jobs على id وslug وtitle وdescription وville وtype_contrat وmode_travail وmetier وsalaire والتواريخ created_at وupdated_at وexpires_at وis_boosted وboost_until. يشير url وapply_url إلى الإعلان على Jawb. توضح total وpage وlimit وnext التنقل بين الصفحات. قد تكون القيم الغائبة null.
عرض الوظائف في موقعك
اجلب التدفق واعرض العناوين والمدن والعقود، واربط زر التقديم بالحقل apply_url. اعرض الوصف كنص باستخدام textContent ولا تحقنه كـ HTML. يسمح CORS بالطلبات من نطاق آخر. يمكن لـ WordPress وغيره من الأنظمة جلب التدفق من الخادم دون إضافة خاصة بـ Jawb.
التحديث والوظائف المغلقة
لا تجلب البيانات أكثر من مرة كل خمس دقائق. قد تؤخر الذاكرة المؤقتة التغييرات لبضع دقائق. استبدل القائمة القديمة بالنتيجة الكاملة لأن الوظائف المغلقة والمؤرشفة والمنتهية تختفي من التدفق. إذا لم توجد وظائف تكون jobs: [] وtotal: 0، ويجب عرض رسالة واضحة.
معالجة الأخطاء
200 تعني نتيجة سليمة، و400 تعني معرفاً أو معاملات غير صالحة، و404 تعني شركة غير موجودة أو مخفية، و503 تعني عطلاً مؤقتاً. عند 503 احتفظ مؤقتاً بآخر قائمة سليمة وأوضح تأخر التحديث ثم أعد المحاولة بفواصل متزايدة. لا تعرض عطل الشبكة على أنه غياب للوظائف.
حدود التدفق العام
يتيح التدفق قراءة الوظائف فقط، ولا ينشر الإعلانات أو يعدل التوظيف أو ينزل السير الذاتية والطلبات. لا ينقل بيانات الدخول أو جهات اتصال المرشحين الخاصة. تتم الطلبات والاختبارات على Jawb. يعرض RSS العام على /rss.xml أحدث 50 وظيفة مع مرشحات ville وmetier، ولا يعوض تدفق الشركة الخاص.
اختبار تدفق شركتك
ستظهر نتيجة الاختبار هنا.
/api/entreprises/boostlab/offres.jsonمثال JavaScript لمطور موقعك
const endpoint = 'https://jawb.ma/api/entreprises/boostlab/offres.json?lang=ar&limit=100';
let next = endpoint;
const jobs = [];
while (next) {
const response = await fetch(new URL(next, 'https://jawb.ma'));
if (!response.ok) throw new Error('HTTP ' + response.status);
const data = await response.json();
jobs.push(...data.jobs);
next = data.next;
}
const list = document.createElement('ul');
for (const job of jobs) {
const item = document.createElement('li');
const link = document.createElement('a');
link.href = job.apply_url;
link.textContent = job.title + ' — ' + job.ville;
item.append(link);
list.append(item);
}
document.querySelector('#jobs').replaceChildren(list);<div id="jobs"></div>