Meta diária NaNoWriMo

Objetivos negativos, dias decorridos negativos e palavras escritas negativas são rejeitados como invalid_input, em vez de produzir em silêncio um ritmo invertido ou imaginário.

O que a meta diária de NaNoWriMo é de fato

O calendário oficial do NaNoWriMo tem trinta dias. Quem começa com um objetivo de cinquenta mil palavras e zero palavras no dia zero precisa, portanto, de cinquenta mil dividido por trinta, ou seja mil seiscentas sessenta e seis e dois terços de palavras por dia, convencionalmente elevadas a mil seiscentas sessenta e sete palavras inteiras para que o total inteiro ainda feche o rascunho. Depois de dez dias com doze mil palavras na página, restam trinta e oito mil palavras e vinte dias, então a meta é exatamente mil e novecentas palavras por dia. Esse é o algoritmo inteiro: remaining_words equivale ao maior entre zero e target_words menos words_written; remaining_days equivale a trinta menos days_elapsed; words_per_day é remaining_words dividido por remaining_days, elevado à próxima palavra inteira quando o quociente ainda não é um inteiro. Quando remaining_words já é zero, a meta é zero: o objetivo foi atingido e não se exige um alvo diário extra. Quando remaining_days é zero e ainda restam palavras, a janela do desafio fechou com o rascunho inacabado, e este endpoint informa invalid_input em vez de dividir por zero ou inventar um milagre de último dia. A calculadora não inventa uma data de calendário, não consulta um relógio e não assume que hoje é novembro; você envia days_elapsed como número para que um ensaio em julho, uma simulação de sala e uma corrida real de novembro usem o mesmo contrato. Recuperar o ritmo depois de uma semana lenta é simplesmente um remaining_words maior sobre menos remaining_days, e por isso a meta sobe quando você atrasa e desce quando você se adianta.

Contrato de entrada, forma da resposta e comportamento de erro

Validação falha não é cobrada. Envie por POST um corpo JSON com três números finitos obrigatórios: target_words, o objetivo de palavras do romance (classicamente cinquenta mil, mas qualquer total finito não negativo é aceito); days_elapsed, quantos dos trinta dias do desafio já passaram; e words_written, o acumulado já na página. Aceitam-se os aliases target, word_goal e goal para o primeiro campo; elapsed, elapsed_days e days para o segundo; written, current e word_count para o terceiro. Cada campo pode chegar como número JSON ou como cadeia numérica. Campos ausentes, cadeias vazias e valores não finitos falham com invalid_input nomeando o campo. Qualquer entrada negativa falha com invalid_input: o NaNoWriMo não pode dever palavras negativas, não pode desfazer dias decorridos nem desescrever um rascunho. days_elapsed não pode ultrapassar trinta, a duração publicada do desafio; um valor maior que trinta tornaria remaining_days negativo, a mesma classe de erro de uma entrada negativa. Em caso de sucesso, o corpo ecoa as três entradas, informa challenge_days como trinta, remaining_words, remaining_days, words_per_day como a meta diária inteira, words_per_day_exact como o quociente sem arredondar, already_finished como booleano e uma cadeia formula que reafirma a identidade. Exemplo: target_words cinquenta mil, days_elapsed dez, words_written doze mil produz remaining_words trinta e oito mil, remaining_days vinte e words_per_day mil e novecentas. A ferramenta do navegador é grátis; chamadas API bem-sucedidas usam saldo pré-pago KIT a US$ 0,002 por item.

Onde uma API de palavras por dia de NaNoWriMo realmente vale

Grupos de escrita mantêm um painel compartilhado de NaNoWriMo para que cada integrante cole um objetivo, os dias decorridos e a contagem atual e veja uma única meta diária comparável, em vez de cinco fórmulas incompatíveis de planilha. Quem edita um sprint de trinta dias pode executar de novo a calculadora quando um cliente sobe o objetivo de cinquenta mil para setenta mil sem reescrever um script sob medida. Unidades de romance em sala usam o mesmo endpoint como ferramenta de ensino: estudantes que começam tarde veem um quociente de dias restantes mais alto e aprendem, em números, por que recuperar o atraso é mais difícil do que começar no dia um com um arquivo em branco. Rastreadores pessoais e aplicativos de hábito chamam a API depois de cada sessão para que a tela inicial mostre o words_per_day de amanhã sem embutir uma aritmética de calendário que desvia quando alguém trata novembro como se tivesse trinta e um dias. Automação que já guarda uma contagem a partir de um formulário de progresso deve chamar este endpoint em vez de fixar cinquenta mil dividido por trinta, valor correto só na manhã do dia um com um manuscrito vazio. Como a implementação é parse pura de nível A, sem rede e sem tokens de modelo, cada chamada bem-sucedida custa o preço-base publicado US$ 0,002, a validação falha não consome saldo e a meta inteira é plenamente determinística para testes, plugins LMS e workers na borda. Mantenha days_elapsed no intervalo fechado de zero a trinta, os outros dois campos não negativos, e você obtém um ritmo NaNoWriMo reproduzível sem montar uma integração própria de plataforma de escrita.