Tägliche Sprachminuten zum Ziel

Wenn die erfassten Stunden das Ziel bereits erreichen, sinken die Tagesminuten auf null und already_reached wird wahr. Ein Null-Tage-Fenster oder ein Ruheplan ohne Übungstag wird mit invalid_input abgelehnt.

Vom Stundenziel zu Übungsminuten, Ruhetagen und Sitzungen

Ruhetage werden nicht über übrige Wochentage gestreut: nur jede vollständige Sieben-Tage-Woche im Kalenderfenster erhält rest_days_per_week ganze freie Tage, daher ergeben dreißig Kalendertage mit einem Ruhetag pro Woche vier Ruhetage und sechsundzwanzig Übungstage. Sind die Reststunden bereits null, sind Tages- und Sitzungsminuten null und already_reached ist wahr, damit Planer keine weiteren Blöcke mehr setzen, statt negative Übung zu erfinden. Die Deckenfelder daily_minutes_ceil und session_minutes_ceil heben die exakten Quotienten auf ganze Minuten, damit ein Timer oder eine Lern-App einen Block reservieren kann, ohne durch Rundung zu wenig zu üben.

Eingabevertrag, Antwortform und Fehlerverhalten

Bevorzugen Sie reine Zahlen statt Zeichenketten mit Einheiten; numerische Zeichenketten werden nur akzeptiert, wenn sie einem strengen Muster für endliche Zahlen ohne Kommas oder Etiketten entsprechen. Senden Sie einen JSON-Körper mit zwei erforderlichen endlichen Zahlen und drei optionalen Tempfeldern. goal_hours (Aliasse total_hours, target_hours, hours_goal) ist das nicht-negative Sprachstunden-Soll. days (Aliasse days_left, days_available, calendar_days) ist das Kalenderfenster und muss strikt größer als null sein. hours_completed (Aliasse completed, already_practiced, hours_done) ist null, wenn weggelassen, und muss bei Angabe nicht-negativ sein. rest_days_per_week (Aliasse rest_days, weekly_rest, off_days) ist eine ganze Zahl von null bis sechs und ist standardmäßig null; sieben Ruhetage in einer Woche ließen keinen Übungstag und werden abgelehnt. sessions_per_day (Aliasse sessions, sessions_daily) ist eine ganze Zahl von eins bis vierundzwanzig und ist standardmäßig eins. Absolute Werte bleiben innerhalb einer Billion, damit Zwischenprodukte in IEEE-Doppelpräzision auf dem Worker und im Browser endlich bleiben. Bei Erfolg spiegelt die Antwort die gerundeten Eingaben, remaining_hours und remaining_minutes, full_weeks, rest_days_in_window, practice_days, daily_minutes und daily_minutes_ceil, session_minutes und session_minutes_ceil, weekly_practice_days, weekly_minutes, total_planned_minutes, already_reached, eine dokumentierte Formel, eine kurze englische Nachricht und geordnete Substitutionszeilen wider. Validierungsfehler —fehlende Felder, nicht-endliche Zahlen, Werte außerhalb der Absolutgrenzen, negative Totale oder erfasste Stunden, eine nicht ganzzahlige Ruhe- oder Sitzungszahl, ein Ruhe- oder Sitzungswert außerhalb der Spanne, ein nulles oder negatives Tagesfenster oder ein Ruheplan ohne Übungstag— liefern invalid_input und werden nicht berechnet. Der Preis ist ein festes $0.002 pro erfolgreichem Aufruf mit Einheit item.

Wo eine API für tägliche Sprachminuten sich rechnet

SRS- und Sprech-Apps rufen dasselbe reine Modul auf, wenn Lernende ein Stundenziel und ein Datum setzen, und rechnen neu, wenn hours_completed nach jeder erfassten Sitzung aktualisiert wird. Weil die Implementierung analytische Parse-Arbeit der Stufe A ist, kostet jeder erfolgreiche Aufruf den veröffentlichten Grundpreis $0.002 ohne Modell-Tokens und ohne ausgehendes Netz.