Memojin
Connexion

Séances d’étude et statistiques

Les séances d’étude du compte (statut, espace, cartes vues et réussies) et ses statistiques : cartes maîtrisées, temps d’étude, taux de réussite.

api.memojin.com/v1 · Contrat 1.0.0-beta.2 · Bêta

Sections · Séances et statistiques
Sur cette page
  1. L’objet StudySession
  2. L’objet LearningStats
  3. Lister les séances d’étude
  4. Lire les statistiques d’apprentissage

Le suivi de l’apprentissage du compte au nom duquel la clé agit, en lecture : ses séances de révision et d’entraînement, avec leurs compteurs, et ses statistiques (cartes maîtrisées, temps d’étude, taux de réussite sur 30 jours, séances terminées). Aucune donnée d’un autre compte, étudiants d’un espace compris, n’est exposée.

L’objet StudySession

Une séance d’étude (révision ou entraînement) du compte.

ChampTypeDescription
idtoujours présentstring (uuid)Identifiant de la séance d’étude (UUID).
typetoujours présentstringType de séance : review, training, srs_daily, exam_preparation, exam_simulation… De nouvelles valeurs peuvent apparaître.
statustoujours présentstringplanned, in_progress, paused, completed ou abandoned.
spaceIdtoujours présentstring | nullEspace de la séance, ou null.
startedAttoujours présentstring (date-time) | nullInstant de début, ou null.
completedAttoujours présentstring (date-time) | nullInstant de fin, ou null tant que la séance n’est pas terminée.
createdAttoujours présentstring (date-time)Instant de création (ISO 8601, UTC).
cardsTotaltoujours présentintegerCartes de la séance.
cardsCompletedtoujours présentintegerCartes répondues.
cardsCorrecttoujours présentintegerCartes réussies.
StudySession
{
  "id": "5d6e7f80-9a1b-4c2d-8e3f-4a5b6c7d8e9f",
  "type": "review",
  "status": "completed",
  "spaceId": null,
  "startedAt": "2026-10-03T18:00:00.000Z",
  "completedAt": "2026-10-03T18:14:00.000Z",
  "createdAt": "2026-10-03T17:59:00.000Z",
  "cardsTotal": 20,
  "cardsCompleted": 20,
  "cardsCorrect": 17
}

L’objet LearningStats

Statistiques d’apprentissage du compte au nom duquel la clé agit.

ChampTypeDescription
masteredMemocardstoujours présentintegerCartes mémo maîtrisées par le compte.
studyTimeMinutestoujours présentintegerTemps d’étude total, en minutes (pauses exclues).
successRatetoujours présentnumberde 0 à 100Part de bonnes réponses sur les 30 derniers jours, en pourcentage (de 0 à 100).
sessionsCompletedtoujours présentintegerSéances d’étude terminées.
LearningStats
{
  "masteredMemocards": 148,
  "studyTimeMinutes": 1260,
  "successRate": 78,
  "sessionsCompleted": 64
}

Lister les séances d’étude

GET/v1/study-sessionsScope study-sessions:read

Les séances de révision et d’entraînement du compte au nom duquel la clé d’API agit, de la plus récente à la plus ancienne, avec leurs compteurs, paginées.

Paramètres

ChampOùTypeDescription
statusfacultatifrequête"planned" | "in_progress" | "paused" | "completed" | "abandoned"Seulement les séances dans cet état.
spaceIdfacultatifrequêtestring (uuid)Seulement les séances de cet espace.
limitfacultatifrequêteintegerde 1 à 100 · défaut 20Nombre d’éléments par page, de 1 à 100 (20 par défaut).
cursorfacultatifrequêtestring200 caractères au plusCurseur opaque : le nextCursor de la page précédente. Gardez le même limit d’une page à l’autre.

Réponse 200

Une page de séances d’étude — Une page de StudySession { data, nextCursor, hasMore }

Erreurs

HTTPSignification
400validation_error ou invalid_cursor
401invalid_api_key ou revoked_api_key
403insufficient_scope, account_suspended, live_not_enabled ou forbidden
406not_acceptable — l’en-tête Accept exclut application/json
429rate_limited ou test_quota_exceeded — voyez les en-têtes Retry-After et RateLimit-*
500internal_error
503unavailable — voyez l’en-tête Retry-After
Requête
curl "https://api.memojin.com/v1/study-sessions?limit=20" \
  -H "Authorization: Bearer $MEMOJIN_API_KEY"
Réponse 200
{
  "data": [
    {
      "id": "5d6e7f80-9a1b-4c2d-8e3f-4a5b6c7d8e9f",
      "type": "review",
      "status": "completed",
      "spaceId": null,
      "startedAt": "2026-10-03T18:00:00.000Z",
      "completedAt": "2026-10-03T18:14:00.000Z",
      "createdAt": "2026-10-03T17:59:00.000Z",
      "cardsTotal": 20,
      "cardsCompleted": 20,
      "cardsCorrect": 17
    }
  ],
  "nextCursor": null,
  "hasMore": false
}

Lire les statistiques d’apprentissage

GET/v1/learning-statsScope learning-stats:read

Cartes mémo maîtrisées, temps d’étude, taux de réussite sur 30 jours et séances terminées du compte au nom duquel la clé d’API agit.

Réponse 200

Les statistiques — Un objet LearningStats

Erreurs

HTTPSignification
401invalid_api_key ou revoked_api_key
403insufficient_scope, account_suspended, live_not_enabled ou forbidden
406not_acceptable — l’en-tête Accept exclut application/json
429rate_limited ou test_quota_exceeded — voyez les en-têtes Retry-After et RateLimit-*
500internal_error
503unavailable — voyez l’en-tête Retry-After
Requête
curl "https://api.memojin.com/v1/learning-stats" \
  -H "Authorization: Bearer $MEMOJIN_API_KEY"
Réponse 200
{
  "masteredMemocards": 148,
  "studyTimeMinutes": 1260,
  "successRate": 78,
  "sessionsCompleted": 64
}