انتقل إلى المحتوى
jobs.ly للمطوّرين

الاستخدام العادل والتغييرات

الواجهة والخلاصات والأداة مجانية. تساعد هذه القواعد على إبقائها مجانية وسريعة وعادلة للجميع.

الاستخدام العادل

  • اربط كل وظيفة بصفحتها على jobs.ly (حقل url) ليقرأ الزائر طريقة التقديم. تستقبل بعض الوظائف الطلبات خارج المنصة.
  • اذكر مصدر الوظائف، مثل «وظائف من jobs.ly».
  • لا تعرض الوظائف على أنها وظائفك، ولا تطلب أي مبالغ من الباحثين عن عمل.
  • لا تتجاوز 120 طلباً في الدقيقة، واحتفظ بالردود دقيقة على الأقل.
  • استخدم الواجهة والخلاصات لجمع الوظائف، لا صفحات الموقع.
  • قد نحظر العناوين التي تخالف هذه القواعد.

الإصدارات والتغييرات

  • الإصدار 1 (/api/v1) ثابت: قد نضيف حقولاً جديدة، لكننا لا نحذف الحقول الموجودة ولا نغيّرها. تجاهل الحقول التي لا تعرفها.
  • أي تغيير يعطّل الاستخدامات الحالية يأتي في إصدار جديد (/api/v2)، نعلن عنه هنا مسبقاً، ونبقي الإصدار القديم فترة.
  • قد تُضاف مدن أو مجالات أو خيارات جديدة. احصل على قائمتها المحدّثة من /api/v1/meta.

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

التاريخما الذي تغيّر
2026-10-30أصبحت الخلاصتان تقرآن city وcategory كما تقرؤهما الواجهة (الرمز، أو الاسم بالعربية أو الإنجليزية، دون تمييز حالة الأحرف)، وترفضان أي قيمة أخرى بالرمز 400 invalid_parameter بدلاً من إرجاع جميع الوظائف. وأصبحت خلاصة XML لمواقع تجميع الوظائف تقبل أيضاً partner وmember وapply كما تقبلها خلاصة RSS.
2026-10-27أُضيف خيار التصفية apply=jobsly (الواجهة وخلاصة RSS): الوظائف التي يُقدَّم عليها في jobs.ly فقط. وأصبحت قائمة الشريك (partner) لوظائف أعضائه فقط؛ فالمؤسسات المسجّلة لدى الشريك دون عضوية ليست فيها.
2026-10-26أُضيف خيارا التصفية partner وmember (الواجهة وخلاصة RSS)، وpartnerMember في كل وظيفة يُرجعانها: قائمة شريك بوظائف أعضائه (اليوم lbc).
2026-10-26أصبح كود الأداة يحتوي رابطاً داخل مربعها («وظائفنا على jobs.ly»)، يظهر إذا لم يعمل الكود، ويصبح السطر الذي تحت الوظائف إذا عمل. والأكواد التي لا تحتويه تعمل كما كانت.
2026-10-18يمكن للمؤسسات الآن اختيار عدم مشاركة وظائفها مع مواقع الوظائف الأخرى: تُستثنى هذه الوظائف من الخلاصات ومن /jobs/{id} وقوائم /jobs، إلا عند التصفية بـcompany أو client لتلك المؤسسة (أداة الوظائف على موقعها).
2026-10-18أُضيف خيار التصفية client وmeta.client (الواجهة)، وdata-jobsly-client (الأداة)، و/embed/client/{key} (الإطار): نافذة وكالة التوظيف لعميل واحد تحدد العميل بمفتاحه، لا بعنوان صفحة قد ينتقل إلى المؤسسة. ويعمل data-jobsly-company كما كان.
2026-10-16إذا طلبت page بعد آخر صفحة (أو بعد الصفحة 500)، تكون قائمة data الآن فارغة وتبقى قيمة meta.page رقم الصفحة المطلوبة، ولا تُرجع وظائف صفحة أخرى. ويتبع ترتيب «الأحدث أولاً» التاريخ الظاهر على كل وظيفة (وللوظيفة المنقولة من موقع آخر: تاريخ نشرها الأصلي). ولا تتضمن خلاصة XML لمواقع تجميع الوظائف الوظائف التي لا يُعرف تاريخ نشرها الأصلي.
2026-10-15أُضيف منذ الإصدار 1: company.confidential (مؤسسة غير مُعْلَنَة)، وoccupation (ISCO-08)، وcountryCode وlocations، وhiringFor.nameEn، وsalary.formatted؛ ويحتفظ salary بعملة الإعلان وفترته، وقد تكون jobType أو postedAt قيمتها null لوظيفة منقولة من موقع آخر. وإصلاحات: خيار التصفية company (الواجهة والخلاصات والأداة) يُرجع أيضاً الوظائف التي تنشرها وكالة توظيف لتلك المؤسسة باسمها، كما في صفحتها؛ وقيمة company التي لا تصلح عنواناً لصفحة يكون ردها 400 invalid_parameter (والخلاصات: لا وظائف) بدلاً من كل الوظائف؛ وminSalary فوق 100,000 يُقرأ 100,000 بدلاً من تجاهله؛ ولكل خطأ error وmessage.
2026-09الإصدار 1: واجهة الوظائف (/jobs و/jobs/{id} و/meta وopenapi.json)، وخلاصتا RSS وXML، وأداة الوظائف للمواقع.

التواصل

للأسئلة، أو طلبات أكثر، أو استخدام جديد تفكر فيه: hello@jobs.ly.

هل تسمح بملفات تعريف الارتباط من Google Analytics لقياس زيارات صفحاتنا العامة؟ سياسة الخصوصية