public_exercises

List Public Exercises

Changed on

Retrieve public exercises from the DB with optional filtering. Everyone with a valid token can see them.

  • year: Optional year to filter by (e.g. premiere_fr)
  • chapter: Optional chapter to filter by (e.g. derivation_chapitre)
  • themes: Optional list of theme IDs to filter by (OR condition)
  • difficulty: Optional difficulty tag ID to filter by (AND condition)
  • chapter_tags: Optional list of chapter-specific tag IDs (AND condition)
  • sequence_number: Optional sequence number to filter by
  • smart: If True, use smart selection algorithm to select exercises
  • count: Number of exercises to return when using smart selection
get/public-exercises

Request

  • Base URL: https://api.excellence-ai.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.excellence-ai.com/public-exercises
  • Auth: OAuth 2 (password, token URL api/login)

Query parameters

yearstring nullable

Filter by year (e.g. premiere_fr)

chapterstring nullable

Filter by chapter (e.g. derivation_chapitre)

themesstring[] nullable

Filter by theme IDs

difficultystring nullable

Filter by difficulty tag ID

chapter_tagsstring[] nullable

Filter by chapter-specific tags (AND condition)

category_pathstring[] nullable

Filter by category_path prefix. Repeat the query param for each segment, e.g. ?category_path=Terminale&category_path=Probabilités. When provided, skips the legacy themes/chapter_tags filters.

sequence_numberinteger nullable

Filter by exercise sequence number

subject'maths' | 'physique-chimie' nullable

Filter by matière. Defaults to the teacher's own subject; students pass their currently-selected subject. Admins see all when omitted.

smartboolean nullable

Use smart selection algorithm to select exercises

countinteger nullable

Number of exercises to return when using smart selection

Response

Successful Response

idstring required
themesstring[] required
contentstring required
solutionstring required
figure_contentstring nullable
figure_solutionstring nullable
created_atstring date-time required
updated_atstring date-time required
sequence_numberinteger nullable
difficultystring nullable
category_pathstring[]
subject'maths' | 'physique-chimie'
library'excellence' | 'cpge' | 'remediation'
type'exercice' | 'automatisme' | 'application_du_cours'
origin'excellence' | 'saint_jean_hulst' | 'lacordaire'
likes_countinteger
savoirs_faire_idsstring[]
titlestring nullable

Changes