NaNoWriMo-Tagessoll

Negative Ziele, negative verstrichene Tage und negative geschriebene Wörter werden als invalid_input abgewiesen, statt stillschweigend ein rückwärts laufendes oder erfundenes Tempo zu erzeugen.

Was das NaNoWriMo-Tagessoll wirklich ist

Der offizielle NaNoWriMo-Kalender dauert dreißig Tage. Wer mit einem Ziel von fünfzigtausend Wörtern und null Wörtern an Tag null startet, braucht daher fünfzigtausend geteilt durch dreißig, also eintausendsechshundertsechsundsechzig und zwei Drittel Wörter pro Tag, konventionell auf eintausendsechshundertsiebenundsechzig ganze Wörter angehoben, damit die ganze Summe den Entwurf noch schließt. Nach zehn Tagen mit zwölftausend Wörtern auf der Seite bleiben achtunddreißigtausend Wörter und zwanzig Tage, also beträgt das Soll genau eintausendneunhundert Wörter pro Tag. Das ist der ganze Algorithmus: remaining_words gleicht dem Größeren aus null und target_words minus words_written; remaining_days gleicht dreißig minus days_elapsed; words_per_day ist remaining_words geteilt durch remaining_days, dann auf das nächste ganze Wort angehoben, wenn der Quotient noch keine ganze Zahl ist. Wenn remaining_words bereits null ist, ist das Soll null: das Ziel ist erreicht und kein weiteres Tagessoll nötig. Wenn remaining_days null ist und noch Wörter bleiben, hat sich das Zeitfenster mit unfertigem Entwurf geschlossen; dieser Endpunkt meldet das als invalid_input, statt durch null zu teilen oder ein Wunder am letzten Tag zu erfinden. Der Rechner erfindet kein Kalenderdatum, fragt keine Uhr ab und nimmt nicht an, dass heute November ist; Sie übergeben days_elapsed als Zahl, damit eine Probe im Juli, eine Klassensimulation und ein echter Novemberlauf denselben Vertrag nutzen. Aufholen nach einer langsamen Woche ist einfach ein größeres remaining_words über weniger remaining_days, weshalb das Soll steigt, wenn Sie zurückliegen, und fällt, wenn Sie voraus sind.

Eingabevertrag, Antwortform und Fehlerverhalten

Gescheiterte Prüfung wird nicht abgerechnet. Senden Sie per POST einen JSON-Körper mit drei erforderlichen endlichen Zahlen: target_words, das Wortziel des Romans (klassisch fünfzigtausend, aber jede nichtnegative endliche Summe wird angenommen); days_elapsed, wie viele der dreißig Herausforderungstage bereits vergangen sind; und words_written, der laufende Stand auf der Seite. Aliasse target, word_goal und goal gelten für das erste Feld; elapsed, elapsed_days und days für das zweite; written, current und word_count für das dritte. Jedes Feld darf als JSON-Zahl oder als numerische Zeichenkette eintreffen. Fehlende Felder, leere Zeichenketten und nicht endliche Werte scheitern mit invalid_input unter Nennung des Feldes. Jede negative Eingabe scheitert mit invalid_input: NaNoWriMo kann Ihnen keine negativen Wörter schulden, keine Tage rückgängig machen und keinen Entwurf unschreiben. days_elapsed darf dreißig, die veröffentlichte Länge der Herausforderung, nicht überschreiten; ein Wert über dreißig würde remaining_days negativ machen, dieselbe Fehlerklasse wie eine negative Eingabe. Bei Erfolg spiegelt der Körper die drei Eingaben, meldet challenge_days als dreißig, remaining_words, remaining_days, words_per_day als ganzzahliges Tagessoll, words_per_day_exact als ungerundeten Quotienten, already_finished als boolesch und eine formula-Zeichenkette, die die Identität neu formuliert. Beispiel: target_words fünfzigtausend, days_elapsed zehn, words_written zwölftausend ergibt remaining_words achtunddreißigtausend, remaining_days zwanzig und words_per_day eintausendneunhundert. Das Browser-Werkzeug ist kostenlos; erfolgreiche API-Aufrufe nutzen das vorausbezahlte KIT-Guthaben zu $0.002 je Element.

Wo eine NaNoWriMo-Wörter-pro-Tag-API ihren Nutzen verdient

Persönliche Tracker und Habit-Apps rufen die API nach jeder Sitzung auf, damit der Startbildschirm das words_per_day von morgen zeigt, ohne Kalenderarithmetik einzubetten, die driftet, wenn jemand November als einunddreißig Tage behandelt. Weil die Umsetzung reines parse der Stufe A ist, ohne Netz und ohne Modell-Token, kostet jeder erfolgreiche Aufruf den veröffentlichten Grundpreis $0.002, gescheiterte Prüfung wird nicht abgerechnet, und das ganzzahlige Soll ist vollständig deterministisch für Tests, LMS-Plugins und Edge-Worker. Halten Sie days_elapsed im abgeschlossenen Intervall von null bis dreißig, die beiden anderen Felder nichtnegativ, und Sie erhalten ein reproduzierbares NaNoWriMo-Tempo, ohne eine eigene Schreibplattform-Anbindung aufzubauen.