Documentation API

Accès programmatique aux données et aux points d'accès de soumission de Future Science

Aperçu

L'API publique de Future Science offre un accès gratuit et en lecture seule à toutes les initiatives et contributions publiées sur la plateforme. Aucune authentification n'est requise. Toutes les réponses sont renvoyées au format JSON.

URL de base

Tous les points d'accès de l'API sont disponibles sous le chemin de base suivant :

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

Authentification

Aucune authentification n'est requise. L'API publique est ouverte à tous. Tous les points d'accès sont en lecture seule.

Pagination

Les points d'accès de liste prennent en charge la pagination via des paramètres de requête. La réponse inclut un objet meta avec les détails de pagination.

Paramètres de requête

Paramètre	Type	Description
`cursor`	number	Numéro de page (commence à 1)
`limit`	number	Nombre d'éléments par page (1–100, par défaut 10)
`search`	string	Terme de recherche pour filtrer les résultats par contenu textuel
`sort`	string	Champ et ordre de tri (ex. title:asc, createdAt:desc)

Réponse de pagination

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

Points d'accès

GET/api/v1/public/initiatives

Lister les initiatives

Renvoie une liste paginée de toutes les initiatives publiées avec leurs métadonnées.

Paramètre	Type	Description
`cursor`	number	Numéro de page (commence à 1)
`limit`	number	Nombre d'éléments par page (1–100, par défaut 10)
`search`	string	Terme de recherche pour filtrer les résultats par contenu textuel
`sort`	string	Champ et ordre de tri (ex. title:asc, createdAt:desc)

Réponse

{
  "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

Obtenir une initiative

Renvoie une initiative publiée par son identifiant de document, y compris ses contributions associées.

Paramètre	Type	Description
`id`	string	L'identifiant de document de la ressource

Réponse

{
  "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

Lister les contributions

Renvoie une liste paginée de toutes les contributions publiées avec leurs métadonnées.

Paramètre	Type	Description
`cursor`	number	Numéro de page (commence à 1)
`limit`	number	Nombre d'éléments par page (1–100, par défaut 10)
`search`	string	Terme de recherche pour filtrer les résultats par contenu textuel
`sort`	string	Champ et ordre de tri (ex. title:asc, createdAt:desc)

Réponse

{
  "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

Obtenir une contribution

Renvoie une contribution publiée par son identifiant de document, incluant les détails complets tels que les auteurs, mots-clés, résumé et fichiers.

Paramètre	Type	Description
`id`	string	L'identifiant de document de la ressource

Réponse

{
  "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"
  }
}

Champs de réponse

Champs d'initiative

Champ	Description
`documentId`	Identifiant unique du document
`title`	Titre de l'initiative
`type`	Type d'initiative
`presentation`	Texte de description de l'initiative
`logo`	Objet image du logo
`leadEditor`	Détails du rédacteur en chef (nom, institution, liens)
`editorialBoard`	Liste des membres du comité éditorial
`supportingDocuments`	Documents justificatifs joints
`publishedAt`	Horodatage de publication

Champs de contribution

Champ	Description
`documentId`	Identifiant unique du document
`title`	Titre de la contribution
`subtitle`	Sous-titre (optionnel)
`type`	Type de contribution
`otherType`	Libellé personnalisé lorsque le type est « Autre »
`abstract`	Texte du résumé
`language`	Langue de la contribution
`author`	Liste des auteurs (nom, institution, email, liens)
`keywords`	Liste de mots-clés
`submittedFiles`	Fichiers soumis et couverture
`additionalMaterials`	Liens de matériaux supplémentaires
`selfArchive`	Détails d'auto-archivage (DOI, licence, droits d'auteur, référence)
`isOriginal`	Indique s'il s'agit d'une soumission originale
`publishedAt`	Horodatage de publication

Types d'initiatives

Les initiatives sur Future Science sont classées dans les types suivants :

Open Review JournalUne revue dirigée par des chercheurs avec une évaluation par les pairs ouverte et transparente. Les évaluations, réponses des auteurs et décisions éditoriales sont accessibles au public.

Open Review Conference ProceedingsUn volume rassemblant des contributions évaluées par les pairs issues d'événements académiques, incluant du matériel multimédia.

Open Review ArchiveUne archive ouverte où tout chercheur peut déposer un travail soumis à une évaluation ouverte communautaire.

Open Review NotebookUne archive fermée réservée à une communauté spécifique (ex. un laboratoire), permettant le travail partagé et l'évaluation ouverte interne.

AI-Reviewed JournalUne revue utilisant l'intelligence artificielle pour assister le processus éditorial et d'évaluation, incluant le traitement des documents et l'attribution des évaluateurs.

Fully Autonomous JournalUn environnement expérimental où la génération d'articles, l'évaluation par les pairs et les décisions éditoriales sont effectuées par des agents IA autonomes.

AutreUn type d'initiative personnalisé défini par le rédacteur en chef.

Types de contributions

Les contributions soumises aux initiatives peuvent être des types suivants :

Article

Communication de conférence

Livre

Chapitre de livre

Réponse à une contribution

Réponse à une évaluation

Manuscrit non évalué

Évaluation par les pairs

Manuscrit révisé

Podcast

Autre

Exemple de requête et réponse

Requête

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

Réponse

{
  "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.

Réponses d'erreur

Lorsqu'une ressource est introuvable, l'API renvoie un statut 404 avec un message d'erreur :

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

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

L'API publique n'a pas de limites de taux strictes, mais veuillez l'utiliser de manière responsable. Les requêtes automatisées excessives peuvent être limitées.