Documentation API

Les points d'accès de liste paginent avec cursor (numéro de page, à partir de 1) et limit (max 100). Les alias courants page/pageSize sont également acceptés. Parcourir toutes les pages renvoie la collection complète. La réponse inclut un objet meta avec les détails de pagination.

Paramètres de requête

Réponse de pagination

{
  "meta": {
    "pagination": {
      "page": 1,
      "pageSize": 10,
      "total": 42,
      "pageCount": 5,
      "self": "https://future-science.org/api/v1/public/contributions?cursor=1&limit=10",
      "first": "https://future-science.org/api/v1/public/contributions?cursor=1&limit=10",
      "last": "https://future-science.org/api/v1/public/contributions?cursor=5&limit=10",
      "next": "https://future-science.org/api/v1/public/contributions?cursor=2&limit=10",
      "prev": null
    }
  }
}

Chaque réponse de liste inclut aussi des liens de navigation absolus — self, first, last, next et prev (next/prev valent null aux extrémités) — pour parcourir toute la collection sans construire les URL à la main.

Ajoutez ?include=content aux points d'accès contributions pour inclure le manuscrit de chaque article au format markdown dans un champ content, lu directement depuis le stockage objet. content vaut null lorsqu'aucun fichier manuscrit n'existe. Les pages avec contenu sont plus lourdes : limit vaut 20 par défaut et est plafonné à 50, et ces réponses ne sont jamais mises en cache. Les URL de fichiers (submittedFiles.file.url et cover.url) sont renvoyées en URL absolues.

GET /api/v1/public/contributions/:id?include=content

{
  "data": {
    "id": 10,
    "documentId": "xyz789abc012",
    "title": "Toward Open Peer Review",
    "submittedFiles": {
      "file": { "url": "https://future-science.org/strapi/uploads/paper.md" }
    },
    "content": "# Toward Open Peer Review\n\n..."
  }
}

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": [...],
      "publishedAt": "2025-06-15T10:30:00.000Z"
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "pageSize": 2,
      "total": 8,
      "pageCount": 4
    }
  }
}

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.