Compte

L’objet account

Le compte auquel appartient la clé d’API : votre organisation, et la clé de la requête avec ses droits et son expiration.

Attributs

idstring

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

objectenum

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

Valeurs possibles

account

api_keyobject

La clé d’API de la requête.

Attributs enfants

idstring: La référence de la clé, telle que la console d’administration l’affiche (pas son secret).
scopesarray of enum: Ce que la clé peut lire : ses droits, triés. Un client doit accepter une valeur qu’il ne connaît pas.
Valeurs possibles
events_read
registrations_read
calls_for_papers_read
expires_attimestamppeut être null: L’expiration de la clé, en secondes Unix (UTC) : elle est refusée à partir de cette date (api_key_invalid) ; null si la plateforme n’a pas donné d’expiration.

Exemple d’objet

{
  "id": "ORG-7b2c9e40-1a5d-4c83-9f6e-3d8a0b4c2e71",
  "object": "account",
  "api_key": {
    "id": "APIK-4f8a2c1e-9b3d-4e6a-8c7f-2a1e5d9b0c34",
    "scopes": [
      "calls_for_papers_read",
      "events_read",
      "registrations_read"
    ],
    "expires_at": 1824076800
  }
}

Lire le compte

GET/v1/account

Renvoie le compte auquel appartient la clé d’API : l’identifiant de votre organisation, et l’identifiant, les droits et l’expiration de la clé. Toute clé valide peut l’appeler, quels que soient ses droits : c’est l’appel qui vérifie qu’une clé fonctionne.

Fonctionne avec toute clé valide.

Aucun paramètre.

Renvoie

Renvoie l’objet account.

Codes d’erreur

Requête

curl

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

JavaScript

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

Python

import requests

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

Réponse

{
  "id": "ORG-7b2c9e40-1a5d-4c83-9f6e-3d8a0b4c2e71",
  "object": "account",
  "api_key": {
    "id": "APIK-4f8a2c1e-9b3d-4e6a-8c7f-2a1e5d9b0c34",
    "scopes": [
      "calls_for_papers_read",
      "events_read",
      "registrations_read"
    ],
    "expires_at": 1824076800
  }
}