MultiTimer API
A software interface that allows you to link MultiTimer with other apps together.
A new kind of API
multitimer://api2/[path]?a=[action]&v=[value]&m=[model]&s=[state]
The `multitimer` API is used to control multiple timers by specifying actions, paths, and optional parameters such as value, models, and states.
**[path]:** Path to the instrument.
- Consists of the board name and instrument name.
- The first parameter is the board, and the second is the instrument.
- Both parameters are optional. If the instrument is specified, the board must also be specified (it can be an empty value or "*").
- Examples:
`/*/lunch` (board unspecified, instrument "lunch")
`/cook/tea` (board "cook", instrument "tea")
`//soup` (board unspecified, instrument "soup")
`/morning` (board "morning", instrument unspecified)
**[action]:** Specifies the action to be performed on the instrument.
- Possible actions:
`tap`, `start`, `reset`, `lap`, `pause`, `resume`, `plus`, `minus`, `next`, `show`
- Required parameter.
**[value]:** Optional parameter specifying a numerical value for the instrument.
- Example: `v=120` to set the value to 120.
- Must be an integer.
- If the value is invalid, an error will be thrown during parsing.
**[model]:** Optional parameter specifying the type of instrument.
- Can be one of the following values:
`countdown`, `quick`, `interval`, `pomodoro`, `countup`, `stopwatch`, `counter`, `button`
**[state]:** Optional parameter specifying the status of the instrument.
- Can be one of the following values:
`inactive`, `running`, `waiting`, `completed`
**Example:**
- `multitimer://api2/?a=reset`
- `multitimer://api2/workout/mat?a=start&m=interval&s=inactive`
- `multitimer://api2/?a=pause&m=interval`
- `multitimer://api2/main/count?a=plus&v=10`
- `multitimer://api2//tool?a=start&s=waiting`