ForHosting KIT · Outils pour développeurs

Trouvez des livres adaptés au niveau de lecture d’un élève

Un niveau de lecture devient vraiment utile lorsqu’il transforme une longue liste de livres en un choix facile à examiner.

● BetaGratuit · dans votre navigateur
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Cet outil compare le niveau scolaire équivalent d’un élève au niveau attribué à chaque ouvrage, puis ne retient que les titres situés dans une plage inclusive. Vous pouvez conserver la marge par défaut d’un niveau en dessous et au-dessus, ou régler chaque côté pour apporter davantage de soutien ou de difficulté. L’ordre initial reste intact afin de faciliter l’utilisation du résultat dans un cours, une bibliothèque ou un entretien de lecture.

Constituez une sélection exploitable

Commencez par le niveau de lecture actuel de l’élève, exprimé en équivalent scolaire, et par une liste de livres évalués selon un même système ou des sources raisonnablement comparables. Chaque entrée doit comporter un titre et un niveau numérique. Cette cohérence est importante, car deux éditeurs peuvent estimer différemment la difficulté d’un texte tout en affichant une valeur proche d’un niveau scolaire. L’outil n’invente, ne déduit et ne recherche aucun niveau : il évalue les données que vous fournissez. Par défaut, il accepte les livres situés entre un niveau au-dessous et un niveau au-dessus de celui de l’élève, bornes comprises. L’ordre saisi est conservé, ce qui vous permet de classer auparavant les titres par thème, disponibilité ou préférence. Un ouvrage hors de l’intervalle est simplement écarté. Un résultat vide est valide : il indique qu’il faut proposer d’autres titres ou élargir la plage, et non que le calcul a échoué.

Réglez séparément soutien et difficulté

Les écarts inférieur et supérieur se modifient indépendamment avec range_below et range_above. Cette dissymétrie est utile, car une sélection pertinente n’est pas toujours centrée sur un score unique. Pour une lecture autonome, vous pouvez autoriser davantage de marge vers le bas tout en gardant une limite supérieure proche. Pour une lecture accompagnée, la marge supérieure peut être plus large. La valeur zéro aligne la borne concernée sur le niveau de l’élève, et la borne inférieure ne descend jamais sous zéro. Considérez ces réglages comme une aide à la sélection, jamais comme un diagnostic. Un équivalent scolaire résume certains aspects de la difficulté, sans mesurer les connaissances préalables, la motivation, le décodage, l’expérience linguistique ou les centres d’intérêt. Après le filtrage, examinez le contenu, l’objectif, le format et l’accompagnement disponible. La meilleure plage produit des choix féconds pour une activité précise tout en laissant place au jugement professionnel et à la voix de l’élève.

Interprétez et réutilisez le résultat

La réponse indique le niveau de l’élève, les bornes minimale et maximale appliquées, le nombre de correspondances et les livres retenus. La décision est donc explicite : chaque titre renvoyé possède un niveau fourni supérieur ou égal au minimum et inférieur ou égal au maximum. L’algorithme est déterministe, si bien qu’une même entrée donne toujours la même sortie. Il ne consulte aucun catalogue externe et n’envoie pas la liste à un service d’enrichissement. Ce fonctionnement convient aux outils scolaires, aux opérations de bibliothèque et aux traitements de données reproductibles. Conservez la plage avec la liste générée si vous devez documenter votre choix, notamment lorsque plusieurs activités emploient des tolérances différentes. Si la source modifie le niveau d’un livre, actualisez l’entrée puis relancez le filtre. L’absence d’un titre ne juge ni sa valeur littéraire ni les capacités de l’élève : sa valeur numérique se trouve seulement hors de la plage. La décision finale doit aussi tenir compte de l’accessibilité, de l’âge, du programme et des intérêts.

Préparez un rayon de lecture autonome

Filtrez les ouvrages de la classe selon une plage favorable avant de laisser l’élève choisir thèmes et formats.

Planifiez une lecture accompagnée

Élargissez la borne supérieure lorsque l’enseignement et les échanges soutiennent des textes plus exigeants.

Examinez les conseils d’une bibliothèque

Réduisez une longue liste à des candidats compatibles sans modifier l’ordre de la sélection initiale.

Quelle plage est appliquée par défaut ?

Les livres compris entre un niveau sous et un niveau au-dessus de l’équivalent scolaire de l’élève sont inclus, bornes comprises.

Les marges inférieure et supérieure peuvent-elles différer ?

Oui. Réglez range_below et range_above séparément selon le soutien, l’objectif et la difficulté de l’activité.

L’outil recherche-t-il le niveau des livres ?

Non. Il filtre uniquement les titres et niveaux transmis dans la demande, sans interroger de base externe.

Que se passe-t-il si aucun livre ne convient ?

Le résultat contient un tableau matched_books vide et un matched_count égal à zéro. Vous pouvez modifier la plage ou la liste.

Une correspondance de niveau constitue-t-elle une recommandation complète ?

Non. Il s’agit d’un tri numérique. Tenez également compte des intérêts, du contenu, de l’accessibilité, de la langue, de l’objectif et de l’aide disponible.

Quel est le prix d’une demande API ?

Chaque demande API coûte $0.002. La version pour navigateur exécute la même logique déterministe sans recherche en ligne.

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

POSThttps://api.kit.forhosting.com/edu/reading-level-book-match

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

curl -X POST https://api.kit.forhosting.com/edu/reading-level-book-match \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"student_level":4.5,"books":[{"title":"The Wild Robot","reading_level":4.2},{"title":"Charlotte'\''s Web","reading_level":4.4},{"title":"The Giver","reading_level":6.8}]}'
{
  "student_level": 4.5,
  "books": [
    {
      "title": "The Wild Robot",
      "reading_level": 4.2
    },
    {
      "title": "Charlotte's Web",
      "reading_level": 4.4
    },
    {
      "title": "The Giver",
      "reading_level": 6.8
    }
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "edu.reading_level_book_match",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →