Appels à communications

L’objet call_for_papers

Un appel à communications d’un événement : la période pendant laquelle les auteurs soumettent leurs communications, et les thèmes auxquels ils les soumettent.

Attributs

idstring

Identifiant unique de l’objet : la référence de l’appel sur la plateforme.

objectenum

Texte qui indique le type de l’objet. Toujours call_for_papers.

Valeurs possibles

call_for_papers

eventstring or expanded event objectdéveloppable

L’événement de l’appel : son identifiant, ou l’objet événement lorsqu’il est développé (expand[]=event, ou expand[]=data.event dans une liste ; demande events_read).

titlestring

Le titre de l’appel.

statusenum

Le statut de l’appel (les mêmes valeurs que celui d’un événement). Un client doit accepter une valeur qu’il ne connaît pas : l’ajout d’une valeur est une évolution compatible.

Valeurs possibles

draft
scheduled
opened
suspended
reported
closed
canceled

typeenumpeut être null

La nature des communications que l’appel recueille ; null s’il n’en a pas. Un client doit accepter une valeur qu’il ne connaît pas.

Valeurs possibles

academic_conferences
journals_and_periodicals
special_issues
workshops_and_symposium
research_competitions
theses_and_dissertations
grant_proposals
book_chapters
call_for_abstracts
panel_proposals

submissions_open_attimestamppeut être null

L’ouverture des soumissions, en secondes Unix (UTC) ; null si elle n’est pas fixée.

submissions_close_attimestamppeut être null

La clôture des soumissions, en secondes Unix (UTC) ; null si elle n’est pas fixée.

themesarray of object

Les thèmes de l’appel, triés par nom ; [] s’il n’en a aucun.

Attributs enfants

namestringpeut être null: Le nom du thème.
descriptionstringpeut être null: Ce que couvre le thème ; null s’il n’est pas décrit.

createdtimestamp

La date de création de l’objet, en secondes Unix (UTC).

updatedtimestamppeut être null

La date de la dernière modification de l’objet, en secondes Unix (UTC) ; null si la plateforme n’en a pas.

Exemple d’objet

{
  "id": "CFP-2d9b6f14-7a3c-4b58-8e01-c4f7a2d95b83",
  "object": "call_for_papers",
  "event": "EVT-5a1f0c2e-3b7d-4e91-9c2a-1d6e8f4b7a30",
  "title": "Call for papers 2027",
  "status": "opened",
  "type": "academic_conferences",
  "submissions_open_at": 1788217200,
  "submissions_close_at": 1798761600,
  "themes": [
    {
      "name": "Energy storage",
      "description": "Batteries, hydrogen and thermal storage at every scale."
    },
    {
      "name": "Solar power",
      "description": null
    }
  ],
  "created": 1785625200,
  "updated": 1788217200
}

Lire un appel à communications

GET/v1/calls_for_papers/{id}

Renvoie l’appel à communications de cet identifiant, avec sa période de soumission et ses thèmes triés par nom. expand[]=event donne l’objet événement à la place de son identifiant (la clé doit aussi avoir events_read). Demande le module des appels à communications dans l’offre de votre organisation. Un appel d’une autre organisation renvoie resource_missing, comme un identifiant qui n’existe pas.

Demande le droit calls_for_papers_read.

Paramètres de chemin

idstringobligatoire: L’identifiant de l’appel à communications.

Paramètres de requête

expand[]array of enumfacultatif: event : l’objet événement à la place de son identifiant (demande events_read).
Valeurs possibles
event

Renvoie

Renvoie l’objet call_for_papers.

Codes d’erreur

Requête

curl

curl -G https://api.masterconf.com/v1/calls_for_papers/CFP-2d9b6f14-7a3c-4b58-8e01-c4f7a2d95b83 \
  -H "Authorization: Bearer mcf_your_key"

JavaScript

const res = await fetch("https://api.masterconf.com/v1/calls_for_papers/CFP-2d9b6f14-7a3c-4b58-8e01-c4f7a2d95b83", {
  headers: { Authorization: "Bearer mcf_your_key" },
});
const data = await res.json();

Python

import requests

res = requests.get(
    "https://api.masterconf.com/v1/calls_for_papers/CFP-2d9b6f14-7a3c-4b58-8e01-c4f7a2d95b83",
    headers={"Authorization": "Bearer mcf_your_key"},
)
data = res.json()

Réponse

{
  "id": "CFP-2d9b6f14-7a3c-4b58-8e01-c4f7a2d95b83",
  "object": "call_for_papers",
  "event": "EVT-5a1f0c2e-3b7d-4e91-9c2a-1d6e8f4b7a30",
  "title": "Call for papers 2027",
  "status": "opened",
  "type": "academic_conferences",
  "submissions_open_at": 1788217200,
  "submissions_close_at": 1798761600,
  "themes": [
    {
      "name": "Energy storage",
      "description": "Batteries, hydrogen and thermal storage at every scale."
    },
    {
      "name": "Solar power",
      "description": null
    }
  ],
  "created": 1785625200,
  "updated": 1788217200
}

Lister les appels à communications

GET/v1/calls_for_papers

Renvoie une page des appels à communications de votre organisation, ou de ceux d’un événement avec event, du plus récent au plus ancien (created décroissant, puis id décroissant). Parcourez les pages avec starting_after (ou ending_before). Demande le module des appels à communications dans l’offre de votre organisation. Un événement d’une autre organisation renvoie resource_missing sur event.

Demande le droit calls_for_papers_read.

Paramètres de requête

eventstringfacultatif: Seulement les appels de cet événement (son identifiant).
statusarray of enumfacultatif: Seulement les appels de ce statut. Répétez le paramètre pour en donner plusieurs (status=opened&status=scheduled).
Valeurs possibles
draft
scheduled
opened
suspended
reported
closed
canceled
limitintegerfacultatif: Le nombre d’objets de la page, de 1 à 100 ; au plus 20 quand la requête a un expand[] (chaque champ développé ou inclus coûte des lectures par objet de la page).
Valeur par défaut : 10.
starting_afterstringfacultatif: Un curseur pour la page suivante : l’identifiant d’un objet de cette liste (le dernier de la page que vous avez) ; la page contient les objets qui le suivent. Pas avec ending_before.
ending_beforestringfacultatif: Un curseur pour la page précédente : l’identifiant d’un objet de cette liste (le premier de la page que vous avez) ; la page contient les objets qui le précèdent, dans le même ordre. Pas avec starting_after.
include[]array of enumfacultatif: total_count : ajouter total_count, le nombre d’objets de toute la liste.
Valeurs possibles
total_count
expand[]array of enumfacultatif: data.event : l’objet événement à la place de son identifiant dans chaque appel (demande events_read).
Valeurs possibles
data.event

Renvoie

Renvoie un objet list dont les data sont des objets call_for_papers.

Codes d’erreur

Requête

curl

curl -G https://api.masterconf.com/v1/calls_for_papers \
  -H "Authorization: Bearer mcf_your_key"

JavaScript

const res = await fetch("https://api.masterconf.com/v1/calls_for_papers", {
  headers: { Authorization: "Bearer mcf_your_key" },
});
const data = await res.json();

Python

import requests

res = requests.get(
    "https://api.masterconf.com/v1/calls_for_papers",
    headers={"Authorization": "Bearer mcf_your_key"},
)
data = res.json()

Réponse

{
  "object": "list",
  "url": "/v1/calls_for_papers",
  "has_more": true,
  "data": [
    {
      "id": "CFP-2d9b6f14-7a3c-4b58-8e01-c4f7a2d95b83",
      "object": "call_for_papers",
      "event": "EVT-5a1f0c2e-3b7d-4e91-9c2a-1d6e8f4b7a30",
      "title": "Call for papers 2027",
      "status": "opened",
      "type": "academic_conferences",
      "submissions_open_at": 1788217200,
      "submissions_close_at": 1798761600,
      "themes": [
        {
          "name": "Energy storage",
          "description": "Batteries, hydrogen and thermal storage at every scale."
        },
        {
          "name": "Solar power",
          "description": null
        }
      ],
      "created": 1785625200,
      "updated": 1788217200
    }
  ]
}