دليل استخدام واجهة برمجة التطبيقات (API) لوكالة الأنباء العمانية

مقدمة

توفر وكالة الأنباء العمانية (ONA) واجهة برمجة تطبيقات (API) لتمكين المطورين من الوصول إلى الأخبار والمحتوى بسهولة. يتيح هذا الدليل فهم كيفية استخدام هذه الواجهة وسحب البيانات وفقًا لمتطلباتك.

عنوان الخدمة الأساسي

https://omannews.gov.om/api.ona

1- تحديد اللغة

• العربية: lang=ar
• الإنجليزية: lang=en

مثال: https://omannews.gov.om/api.ona?lang=ar

2- تصفية الأخبار حسب التصنيفات

التصنيفات باللغة العربية:

التصنيفات باللغة الإنجليزية:

3- ترتيب عرض الأخبار

• تنازلي (الأحدث أولاً): sort_order=desc
• تصاعدي (الأقدم أولاً): sort_order=asc

مثال: https://omannews.gov.om/api.ona?sort_order=desc

4- الانتقال بين الصفحات

استخدام معلمة page للانتقال بين الصفحات:

• page=1 - الصفحة الأولى
• page=2 - الصفحة الثانية

مثال: https://omannews.gov.om/api.ona?page=3

5- تحديد عدد الأخبار المعروضة

تحديد عدد الأخبار باستخدام limit بحد أقصى 30.

مثال: https://omannews.gov.om/api.ona?limit=10

6- مثال مكتمل

https://omannews.gov.om/api.ona?lang=ar&limit=10&sort_order=desc&page=3&filter=85

7- دمج الخيارات معًا

https://omannews.gov.om/api.ona?lang=en&filter=80&sort_order=asc&limit=5&page=2