Quota quotidien NaNoWriMo

Les objectifs négatifs, les jours écoulés négatifs et les mots écrits négatifs sont rejetés comme invalid_input, plutôt que de produire en silence un rythme inversé ou imaginaire.

Ce qu'est réellement le quota quotidien NaNoWriMo

Le calendrier officiel du NaNoWriMo dure trente jours. Quiconque part d'un objectif de cinquante mille mots et de zéro mot au jour zéro a donc besoin de cinquante mille divisé par trente, soit mille six cent soixante-six et deux tiers de mots par jour, conventionnellement portés à mille six cent soixante-sept mots entiers afin que le total entier achève encore le brouillon. Après dix jours avec douze mille mots sur la page, il reste trente-huit mille mots et vingt jours, donc le quota est exactement de mille neuf cents mots par jour. Tel est tout l'algorithme : remaining_words égale le plus grand de zéro et de target_words moins words_written ; remaining_days égale trente moins days_elapsed ; words_per_day est remaining_words divisé par remaining_days, puis porté au mot entier suivant lorsque le quotient n'est pas déjà un entier. Lorsque remaining_words est déjà zéro, le quota est zéro : le but est atteint et aucun objectif quotidien supplémentaire n'est exigé. Lorsque remaining_days est zéro et qu'il reste des mots, la fenêtre du défi s'est refermée sur un brouillon inachevé, ce que cet endpoint signale comme invalid_input plutôt que de diviser par zéro ou d'inventer un miracle de dernière heure. Le calculateur n'invente pas une date de calendrier, n'interroge pas une horloge et ne suppose pas que nous sommes en novembre ; vous transmettez days_elapsed comme nombre afin qu'une répétition en juillet, une simulation de classe et une course réelle de novembre utilisent le même contrat. Rattraper une semaine lente, c'est simplement un remaining_words plus grand sur moins de remaining_days, c'est pourquoi le quota monte lorsque vous prenez du retard et baisse lorsque vous prenez de l'avance.

Contrat d'entrée, forme de la réponse et comportement d'erreur

Une validation échouée n'est pas facturée. Envoyez par POST un corps JSON avec trois nombres finis obligatoires : target_words, l'objectif de mots du roman (classiquement cinquante mille, mais tout total fini non négatif est accepté) ; days_elapsed, combien des trente jours du défi sont déjà passés ; et words_written, le cumul déjà sur la page. Les alias target, word_goal et goal sont acceptés pour le premier champ ; elapsed, elapsed_days et days pour le deuxième ; written, current et word_count pour le troisième. Chaque champ peut arriver comme nombre JSON ou comme chaîne numérique. Les champs manquants, les chaînes vides et les valeurs non finies échouent avec invalid_input en nommant le champ. Toute entrée négative échoue avec invalid_input : le NaNoWriMo ne peut pas vous devoir des mots négatifs, ni désécouler des jours, ni désécrire un brouillon. days_elapsed ne peut pas dépasser trente, la durée publiée du défi ; une valeur supérieure à trente rendrait remaining_days négatif, ce qui est la même classe d'erreur qu'une entrée négative. En cas de succès, le corps répète les trois entrées, indique challenge_days égal à trente, remaining_words, remaining_days, words_per_day comme quota quotidien entier, words_per_day_exact comme quotient non arrondi, already_finished comme booléen, et une chaîne formula qui reformule l'identité. Exemple : target_words cinquante mille, days_elapsed dix, words_written douze mille donne remaining_words trente-huit mille, remaining_days vingt et words_per_day mille neuf cents. L'outil du navigateur est gratuit ; les appels API réussis utilisent le solde prépayé KIT à $0.002 par élément.

Où une API de mots par jour NaNoWriMo gagne vraiment sa place

Les groupes d'écriture tiennent un tableau de bord NaNoWriMo partagé afin que chaque membre colle un objectif, les jours écoulés et le décompte actuel et voie un seul quota quotidien comparable, plutôt que cinq formules de tableur incompatibles. Les personnes qui coachent un sprint de trente jours peuvent relancer le calculateur lorsqu'un client fait passer l'objectif de cinquante mille à soixante-dix mille sans réécrire un script sur mesure. Les unités de roman en classe utilisent le même endpoint comme outil pédagogique : les élèves qui commencent tard voient un quotient de jours restants plus élevé et apprennent, en chiffres, pourquoi rattraper est plus difficile que de commencer le jour un avec un fichier vide. Les suiveurs personnels et les applications d'habitude appellent l'API après chaque séance pour que l'écran d'accueil affiche le words_per_day de demain sans embarquer une arithmétique de calendrier qui dérive lorsque l'on traite novembre comme s'il avait trente et un jours. L'automatisation qui stocke déjà un décompte depuis un formulaire de progression devrait appeler cet endpoint plutôt que de figer cinquante mille divisé par trente, valeur correcte seulement le matin du jour un avec un manuscrit vide. Comme l'implémentation est parse pure de niveau A, sans réseau ni jetons de modèle, chaque appel réussi coûte le prix de base publié $0.002, une validation échouée ne consomme pas le solde, et le quota entier est pleinement déterministe pour les tests, les plugins LMS et les workers en périphérie. Conservez days_elapsed dans l'intervalle fermé de zéro à trente, les deux autres champs non négatifs, et vous obtenez un rythme NaNoWriMo reproductible sans monter une intégration de plateforme d'écriture à vous.