Budget tempo del piano di lezione

Una durata non positiva e una somma di pesi zero falliscono con invalid_input invece di inventare un orario.

Come funziona l'allocazione proporzionale del tempo

Se duration_minutes è D e l'attività i ha peso w_i, i minuti allocati sono D per w_i diviso la somma di tutti i pesi. Dopo la moltiplicazione proporzionale, l'arrotondamento in virgola mobile può lasciare un residuo minuscolo così che i minuti ripuliti non sommino esattamente D; questo endpoint assorbe quel residuo nell'ultima attività con peso positivo affinché l'array minutes sia sempre una partizione della durata richiesta. La risposta riporta anche share_ratio e percent per ciascuna attività così che le dashboard traccino la stessa ripartizione senza ricalcolare la somma dei pesi.

Contratto di ingresso, forma della risposta ed errori

Il campo activities è un array non vuoto di oggetti, ciascuno con una stringa name non vuota e un weight numerico finito non negativo. Su questo percorso parse gratuito si accettano fino a cento attività. Un array parallelo minutes rispetta l'ordine di ingresso per gli script che necessitano solo dell'allocazione numerica. Controlli classici in aula includono un blocco di cinquanta minuti con pesi uno, tre, quattro e due per riscaldamento, istruzione diretta, pratica guidata e biglietto di uscita, che produce cinque, quindici, venti e dieci minuti rispettivamente. Colleghi il modulo gratuito del browser a una bacheca di pianificazione per uso umano e chiami lo stesso contratto da un registro o da un servizio di guida al ritmo quando l'automazione richiede cifre identiche. Invii con POST un corpo JSON con due campi obbligatori. Il campo duration_minutes è un numero finito strettamente maggiore di zero che rappresenta la durata totale della lezione in minuti; zero e valori negativi falliscono con invalid_input nominando il campo. Campi mancanti, elenchi vuoti, righe non oggetto, nomi vuoti, numeri non finiti, pesi negativi e somma di pesi zero falliscono con invalid_input e non vengono addebitati. In caso di successo il corpo riecheggia duration_minutes, riporta activity_count e weight_sum e restituisce un array activities di oggetti con index, name, weight, share_ratio, minutes e percent. Method è weighted_time_budget e formula ribadisce che minutes_i è duration_minutes per weight_i sulla somma dei pesi. Le chiamate API riuscite usano il prezzo base pubblicato $0.002 per elemento; i fallimenti di validazione non consumano il saldo prepagato.

Dove un'API di budget tempo lezione dimostra il suo valore

I team di instructional design usano un calcolatore di budget tempo del piano di lezione affinché i modelli multiperiodo restino coerenti quando il distretto accorcia o allunga l'orario del campanello: mantenga gli stessi pesi relativi e riesegua con il nuovo duration_minutes. Gli strumenti di coaching incorporano l'endpoint così che un modulo di osservazione mostri se la quota pianificata di parlato degli studenti ha corrisposto all'orologio osservato, usando percent e minutes da un'unica fonte di verità. I costruttori ed-tech evitano di spedire i propri casi limite in virgola mobile —durata zero, tutti i pesi a zero, arrotondamento residuale— perché quei percorsi sono già coperti da invalid_input deterministico o assorbimento del residuo.