Quota NaNoWriMo

Obiettivi negativi, giorni trascorsi negativi e parole scritte negative vengono rifiutati come invalid_input, invece di produrre in silenzio un ritmo invertito o immaginario.

Che cos'è davvero la quota giornaliera NaNoWriMo

Il calendario ufficiale del NaNoWriMo dura trenta giorni. Chi parte da un obiettivo di cinquantamila parole e zero parole al giorno zero ha dunque bisogno di cinquantamila diviso trenta, ossia milleseicentosessantasei e due terzi di parole al giorno, per convenzione portato a milleseicentosessantasette parole intere così che il totale intero chiuda ancora la bozza. Dopo dieci giorni con dodicimila parole sulla pagina restano trentottomila parole e venti giorni, quindi la quota è esattamente millenovecento parole al giorno. Questo è l'intero algoritmo: remaining_words equivale al maggiore tra zero e target_words meno words_written; remaining_days equivale a trenta meno days_elapsed; words_per_day è remaining_words diviso remaining_days, poi portato alla parola intera successiva quando il quoziente non è già un intero. Quando remaining_words è già zero, la quota è zero: la meta è raggiunta e non si esige un ulteriore obiettivo giornaliero. Quando remaining_days è zero e restano ancora parole, la finestra della sfida si è chiusa con la bozza incompiuta, e questo endpoint lo segnala come invalid_input invece di dividere per zero o inventare un miracolo dell'ultimo giorno. Il calcolatore non inventa una data di calendario, non interroga un orologio e non presume che oggi sia novembre; Lei passa days_elapsed come numero così che una prova a luglio, una simulazione d'aula e una corsa reale di novembre usino lo stesso contratto. Recuperare dopo una settimana lenta è semplicemente un remaining_words più grande su meno remaining_days, ed è per questo che la quota sale quando Lei resta indietro e scende quando Lei anticipa.

Contratto di ingresso, forma della risposta e comportamento di errore

La convalida fallita non viene addebitata. Invii con POST un corpo JSON con tre numeri finiti obbligatori: target_words, l'obiettivo di parole del romanzo (classicamente cinquantamila, ma qualsiasi totale finito non negativo è accettato); days_elapsed, quanti dei trenta giorni della sfida sono già passati; e words_written, il cumulato già sulla pagina. Si accettano gli alias target, word_goal e goal per il primo campo; elapsed, elapsed_days e days per il secondo; written, current e word_count per il terzo. Ogni campo può arrivare come numero JSON o come stringa numerica. Campi assenti, stringhe vuote e valori non finiti falliscono con invalid_input nominando il campo. Qualsiasi ingresso negativo fallisce con invalid_input: il NaNoWriMo non può dovere a Lei parole negative, non può disfare i giorni trascorsi né cancellare una bozza già scritta. days_elapsed non può superare trenta, la durata pubblicata della sfida; un valore maggiore di trenta renderebbe remaining_days negativo, la stessa classe di errore di un ingresso negativo. In caso di successo il corpo ripete i tre ingressi, indica challenge_days pari a trenta, remaining_words, remaining_days, words_per_day come quota giornaliera intera, words_per_day_exact come quoziente non arrotondato, already_finished come booleano e una stringa formula che riformula l'identità. Esempio: target_words cinquantamila, days_elapsed dieci, words_written dodicimila produce remaining_words trentottomila, remaining_days venti e words_per_day millenovecento. Lo strumento del browser è gratuito; le chiamate API riuscite usano il saldo prepagato KIT a $0.002 per elemento.

Dove un'API di parole al giorno NaNoWriMo merita davvero il posto

I gruppi di scrittura tengono un cruscotto NaNoWriMo condiviso così che ogni membro incolli un obiettivo, i giorni trascorsi e il conteggio attuale e veda un'unica quota giornaliera confrontabile, invece di cinque formule di foglio di calcolo incompatibili. Chi cura uno sprint di trenta giorni può rieseguire il calcolatore quando un cliente alza l'obiettivo da cinquantamila a settantamila senza riscrivere uno script su misura. Le unità di romanzo in classe usano lo stesso endpoint come strumento didattico: chi inizia tardi vede un quoziente di giorni restanti più alto e impara, in cifre, perché recuperare è più difficile che cominciare il giorno uno con un file vuoto. I tracciatori personali e le app di abitudine chiamano l'API dopo ogni sessione perché la schermata iniziale mostri il words_per_day di domani senza incorporare un'aritmetica di calendario che deriva quando qualcuno tratta novembre come se avesse trentuno giorni. L'automazione che già memorizza un conteggio da un modulo di progresso dovrebbe chiamare questo endpoint invece di fissare cinquantamila diviso trenta, valore corretto solo la mattina del giorno uno con un manoscritto vuoto. Poiché l'implementazione è parse pura di livello A, senza rete e senza token di modello, ogni chiamata riuscita costa il prezzo base pubblicato $0.002, la convalida fallita non consuma saldo e la quota intera è pienamente deterministica per test, plugin LMS e worker all'edge. Mantenga days_elapsed nell'intervallo chiuso da zero a trenta, gli altri due campi non negativi, e ottiene un ritmo NaNoWriMo riproducibile senza montare un'integrazione propria di piattaforma di scrittura.