Zeitfenster

[thommyb]

Mir ist aufgefallen, dass die Endpunkte verschiedene Query-Attribute für die Angabe eines Zeitfensters nutzen

from/to:
/calendar/appointments
/events
/persons
/resources

from_date/to_date:
/groups/{groupdId}/absences
/persons/{personsId}/absences

start_date/end_date:
/finance/transactions
/groups/{groupId}/meetings
/persons/birthdays (/persons hat außerdem noch birthday_before/birthday_after)
/sync/executions
/sync/logs

Leider kann ich nicht erkennen, was der semantische Unterschied sein soll. Wäre es nicht möglich, diese Attribute zu vereinheitlichen? Dann muss ich mir nur ein Parameter-Paar merken und muss auch nur eine Funktion schreiben, die die Attribute erzeugt und an die Query anhängt. Das würde doch sicher auch der App helfen....

[bwl21]

@thommyb in realität ist kein semantischer unterschied sichtbar. Es wäre sicher sinnvoll, hier ein konsistenteres API anzubieten, aber es würde die Rückwärtskompatibilität brechen.

[thommyb]

@bwl21 Nein, die Rückwartskompatibilität ist kein Problem. Der alte Parameter kann ja weiterhin akzeptiert werden, aber der einheitliche ist der dokumentierte.