apptObject
Defines how and when to return selectable appointments.
{
"appts": <integer>,
"limit": <integer> | null,
"ranks": [real],
"mode": PRIMARY | SECONDARY | null,
"virtual": { "search": timeInterval, "available": dowString, "slots": [HH:MM] } | null,
"resource": <bool>,
"strict": <bool>,
"delayBias": <real>,
"useExtended": <bool>,
"useVoluntary": <bool>,
"useStandby": <bool>,
}
-
searchtimeIntervaldefault5 days - How far into the future Spiral searches for appointments.
-
immediatetimeIntervaldefault2 hours - Prevents adjusting earliest if an appointment is sooner than this.
-
windowtimeIntervaldefault2 hours - Duration of each generated appointment slot.
-
firsttimeIntervaldefault08:00 - Time after midnight when the first appointment window starts.
-
intervaltimeIntervaldefault1 hour - Time between successive appointment windows.
-
apptsintegerdefault0 - Total possible daily appointments.
-
limitinteger - Maximum appointments returned (null = unlimited).
-
ranksreal - Cost thresholds that group ranked appointments (e.g. [0.2, 0.5]).
-
modePRIMARY | SECONDARY - Appointment-generation mode.
-
virtual{ "search": timeInterval, "available": dowString, "slots": [HH:MM] } - Virtual fixed-slot appointments — named slots on given days.
-
resourcebooldefaultfalse - Expose specific-resource vs consolidated options.
-
strictbooldefaultfalse - Keep slots within earliest/latest constraints.
-
availabledowStringdefaultMTWTFSSX - Days of week available for appointments.
-
delayBiasrealdefault0.0 - Preference weighting toward earlier appointments.
-
delayBiasPeriodtimeIntervaldefault1 day - Time over which full delay bias applies (50% at this point).
-
useExtendedbooldefaultfalse - Include extended-time appointments.
-
useVoluntarybooldefaultfalse - Include voluntary-time appointments.
-
useStandbybooldefaultfalse - Include standby-time appointments.