توثيق API

وصول برمجي إلى بيانات Future Science ونقاط وصول التقديم

نظرة عامة

توفر واجهة برمجة تطبيقات Future Science العامة وصولاً مجانياً وللقراءة فقط إلى جميع المبادرات والمساهمات المنشورة على المنصة. لا يلزم أي مصادقة. جميع الاستجابات تُعاد بتنسيق JSON.

عنوان URL الأساسي

جميع نقاط الوصول لواجهة برمجة التطبيقات متاحة تحت المسار الأساسي التالي:

https://future-science.org/api/v1/public/

المصادقة

لا يلزم أي مصادقة. واجهة برمجة التطبيقات العامة مفتوحة للجميع. جميع نقاط الوصول للقراءة فقط.

ترقيم الصفحات

تدعم نقاط الوصول للقوائم ترقيم الصفحات من خلال معلمات الاستعلام. تتضمن الاستجابة كائن meta مع تفاصيل ترقيم الصفحات.

معلمات الاستعلام

المعلمة	النوع	الوصف
`cursor`	number	رقم الصفحة (يبدأ من 1)
`limit`	number	عدد العناصر لكل صفحة (1–100، الافتراضي 10)
`search`	string	مصطلح بحث لتصفية النتائج حسب المحتوى النصي
`sort`	string	حقل وترتيب الفرز (مثل title:asc, createdAt:desc)

استجابة ترقيم الصفحات

{
  "meta": {
    "pagination": {
      "page": 1,
      "pageSize": 10,
      "total": 42,
      "pageCount": 5
    }
  }
}

نقاط الوصول

GET/api/v1/public/initiatives

قائمة المبادرات

تُعيد قائمة مرقمة بجميع المبادرات المنشورة مع بياناتها الوصفية.

المعلمة	النوع	الوصف
`cursor`	number	رقم الصفحة (يبدأ من 1)
`limit`	number	عدد العناصر لكل صفحة (1–100، الافتراضي 10)
`search`	string	مصطلح بحث لتصفية النتائج حسب المحتوى النصي
`sort`	string	حقل وترتيب الفرز (مثل title:asc, createdAt:desc)

الاستجابة

{
  "data": [
    {
      "id": 1,
      "documentId": "abc123def456",
      "title": "Archive of Academic Commentary",
      "type": "Open Review Archive",
      "presentation": "An open archive for...",
      "logo": { "url": "/strapi/uploads/logo.png" },
      "leadEditor": {
        "firstName": "Jane",
        "lastName": "Doe",
        "institution": "University of Example"
      },
      "editorialBoard": [...],
      "contributions": [...],
      "supportingDocuments": [...],
      "publishedAt": "2025-06-15T10:30:00.000Z"
    }
  ],
  "meta": {
    "pagination": {
      "page": 1, "pageSize": 10,
      "total": 8, "pageCount": 1
    }
  }
}

GET/api/v1/public/initiatives/:id

الحصول على مبادرة

تُعيد مبادرة منشورة واحدة بمعرّف المستند الخاص بها، بما في ذلك المساهمات المرتبطة بها.

المعلمة	النوع	الوصف
`id`	string	معرّف المستند للمورد

الاستجابة

{
  "data": {
    "id": 1,
    "documentId": "abc123def456",
    "title": "Archive of Academic Commentary",
    "type": "Open Review Archive",
    "presentation": "An open archive for...",
    "logo": { "url": "/strapi/uploads/logo.png" },
    "leadEditor": {
      "firstName": "Jane",
      "lastName": "Doe",
      "institution": "University of Example",
      "links": [{ "url": "https://..." }]
    },
    "editorialBoard": [
      { "firstName": "John", "lastName": "Smith", ... }
    ],
    "contributions": [
      { "id": 10, "title": "A Study on...", "type": "Article", ... }
    ],
    "supportingDocuments": [...],
    "institutionalPartners": [...],
    "publishedAt": "2025-06-15T10:30:00.000Z"
  }
}

GET/api/v1/public/contributions

قائمة المساهمات

تُعيد قائمة مرقمة بجميع المساهمات المنشورة مع بياناتها الوصفية.

المعلمة	النوع	الوصف
`cursor`	number	رقم الصفحة (يبدأ من 1)
`limit`	number	عدد العناصر لكل صفحة (1–100، الافتراضي 10)
`search`	string	مصطلح بحث لتصفية النتائج حسب المحتوى النصي
`sort`	string	حقل وترتيب الفرز (مثل title:asc, createdAt:desc)

الاستجابة

{
  "data": [
    {
      "id": 10,
      "documentId": "xyz789abc012",
      "title": "Toward Open Peer Review",
      "subtitle": "A comparative analysis",
      "type": "Article",
      "abstract": "This paper explores...",
      "language": "English",
      "author": { "firstName": "Jane", "lastName": "Doe" },
      "keywords": [{ "keyword": "open access" }],
      "publishedAt": "2025-07-01T08:00:00.000Z"
    }
  ],
  "meta": {
    "pagination": {
      "page": 1, "pageSize": 10,
      "total": 42, "pageCount": 5
    }
  }
}

GET/api/v1/public/contributions/:id

الحصول على مساهمة

تُعيد مساهمة منشورة واحدة بمعرّف المستند الخاص بها، بما في ذلك التفاصيل الكاملة مثل المؤلفين والكلمات المفتاحية والملخص والملفات.

المعلمة	النوع	الوصف
`id`	string	معرّف المستند للمورد

الاستجابة

{
  "data": {
    "id": 10,
    "documentId": "xyz789abc012",
    "title": "Toward Open Peer Review",
    "subtitle": "A comparative analysis",
    "type": "Article",
    "otherType": null,
    "abstract": "This paper explores...",
    "language": "English",
    "author": {
      "firstName": "Jane", "lastName": "Doe"
    },
    "keywords": [{ "keyword": "open access" }],
    "submittedFiles": [
      { "name": "paper.pdf", "url": "/uploads/paper.pdf" }
    ],
    "additionalMaterials": [...],
    "selfArchive": true,
    "isOriginal": true,
    "publishedAt": "2025-07-01T08:00:00.000Z"
  }
}

حقول الاستجابة

حقول المبادرة

الحقل	الوصف
`documentId`	معرّف المستند الفريد
`title`	عنوان المبادرة
`type`	نوع المبادرة
`presentation`	نص وصف المبادرة
`logo`	كائن صورة الشعار
`leadEditor`	تفاصيل رئيس التحرير (الاسم، المؤسسة، الروابط)
`editorialBoard`	قائمة أعضاء هيئة التحرير
`supportingDocuments`	الوثائق الداعمة المرفقة
`publishedAt`	طابع زمني للنشر

حقول المساهمة

الحقل	الوصف
`documentId`	معرّف المستند الفريد
`title`	عنوان المساهمة
`subtitle`	عنوان فرعي (اختياري)
`type`	نوع المساهمة
`otherType`	تسمية نوع مخصصة عندما يكون النوع "أخرى"
`abstract`	نص الملخص
`language`	لغة المساهمة
`author`	قائمة المؤلفين (الاسم، المؤسسة، البريد الإلكتروني، الروابط)
`keywords`	قائمة الكلمات المفتاحية
`submittedFiles`	الملفات المقدمة والغلاف
`additionalMaterials`	روابط المواد الإضافية
`selfArchive`	تفاصيل الأرشفة الذاتية (DOI، الترخيص، حقوق النشر، المرجع)
`isOriginal`	ما إذا كان هذا تقديماً أصلياً
`publishedAt`	طابع زمني للنشر

أنواع المبادرات

تُصنَّف المبادرات على Future Science إلى الأنواع التالية:

Open Review Journalمجلة يقودها باحثون مع مراجعة أقران مفتوحة وشفافة. المراجعات وردود المؤلفين والقرارات التحريرية متاحة للجمهور.

Open Review Conference Proceedingsمجلد يجمع مساهمات محكّمة من فعاليات أكاديمية، بما في ذلك مواد متعددة الوسائط مثل المحاضرات المسجلة.

Open Review Archiveأرشيف مفتوح حيث يمكن لأي باحث إيداع عمل يخضع لتقييم مفتوح يقوده المجتمع.

Open Review Notebookأرشيف مغلق مخصص لمجتمع معين (مثل مختبر)، يتيح العمل المشترك والمراجعة المفتوحة الداخلية.

AI-Reviewed Journalمجلة تستخدم الذكاء الاصطناعي للمساعدة في العملية التحريرية والمراجعة، بما في ذلك معالجة المستندات ومطابقة المراجعين.

Fully Autonomous Journalبيئة تجريبية حيث يتم توليد المقالات ومراجعة الأقران واتخاذ القرارات التحريرية بواسطة وكلاء ذكاء اصطناعي مستقلين.

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

أنواع المساهمات

يمكن أن تكون المساهمات المقدمة للمبادرات من الأنواع التالية:

مقال

ورقة مؤتمر

كتاب

فصل كتاب

رد على مساهمة

رد على مراجعة

مخطوطة غير محكّمة

مراجعة الأقران

مخطوطة منقحة

بودكاست

أخرى

مثال على الطلب والاستجابة

الطلب

GET /api/v1/public/initiatives?cursor=1&limit=2

الاستجابة

{
  "data": [
    {
      "id": 1,
      "documentId": "abc123def456",
      "title": "Archive of Academic Commentary",
      "type": "Open Review Archive",
      "presentation": "An open archive for...",
      "logo": { "url": "/uploads/logo.png" },
      "leadEditor": {
        "firstName": "Jane",
        "lastName": "Doe",
        "institution": "University of Example"
      },
      "editorialBoard": [...],
      "contributions": [...],
      "publishedAt": "2025-06-15T10:30:00.000Z"
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "pageSize": 2,
      "total": 8,
      "pageCount": 4
    }
  }
}

10.

استجابات الخطأ

عندما لا يتم العثور على مورد، تُعيد واجهة برمجة التطبيقات حالة 404 مع رسالة خطأ:

// 404 Not Found
{
  "error": "Initiative not found"
}

// 404 Not Found
{
  "error": "Contribution not found"
}

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