الواجهة البرمجية للمؤسسات
تتيح الواجهة لمراكز الأبحاث والجامعات والمؤسسات الإعلامية دمج ملخصات المرصد وترجماته في أنظمتها، بصيغة JSON ثابتة ومعرّفة.
الحصول على مفتاح
تصدر المفاتيح يدوياً للمؤسسات. راسل فريق التحرير باسم المؤسسة والغرض من الاستخدام وعدد الطلبات المتوقع. يظهر المفتاح مرة واحدة عند إصداره، فاحفظه في مكان آمن.
الاستخدام
أرسل المفتاح في الترويسة X-API-Key. لكل مفتاح حد للطلبات في الدقيقة، وتبيّن ترويسات X-RateLimit-* المتبقي منه. عند تجاوزه تعود الاستجابة بالرمز 429 مع مدة الانتظار.
curl -H "X-API-Key: mrsd_..." "https://masader.feedsnews.net/v1/articles?topic=deterrence&per_page=20"| الطلب | ما يعيده |
|---|---|
| GET /v1/articles | المواد المنشورة، مع ترشيح بالموضوع والمنطقة والمصدر واللغة الأصلية والتاريخ |
| GET /v1/articles/{id} | مادة واحدة بملخصها، ونصها المترجم كاملاً حيث تسمح الحقوق |
| GET /v1/search?q=&mode= | بحث بالكلمات أو بالمعنى، بالعربية أو بلغة الأصل |
| GET /v1/sources | المصادر المرصودة ومستوى حقوق كل منها |
| GET /v1/topics | التصنيف الموضوعي والجغرافي مع الأعداد |
| GET /v1/dossiers | الملفات الموضوعية المنشورة |
| GET /v1/trends/{YYYY-MM} | إحصاءات الشهر والقراءة المنشورة |
| GET /v1/glossary | المسرد المعتمد للمصطلحات |
التوثيق التفاعلي الكامل (بالإنجليزية). استخدام الواجهة يعني قبول شروطها.
الحقوق
تطبق الواجهة قواعد الموقع نفسها: لا يُعاد النص الكامل إلا حين يسمح ترخيص المصدر أو إذنه بذلك. احتفظ عند العرض باسم المصدر والمؤلفين ورابط الأصل والترخيص، واذكر مصادر مصدراً للترجمة والملخص.