deceptively simple web service with super powers
TimerCheck.io is a fully functional, fully scalable microservice built
on the just-released Amazon API Gateway and increasingly popular AWS
Lambda platforms.
TimerCheck.io is a public web service that maintains a practically
unlimited number of countdown timers with one second resolution and no
practical limit to the number of seconds each timer can run.
New timers can be created on a whim and each timer can be reset at any
time to any number of seconds desired, whether it is still running or
has already expired.
Synopsis
Let’s begin with an example to demonstrate the elegant simplicity of
the TimerCheck.io interface.
1. Set timer - Any request of the following URL sets a timer named
“YOURTIMERNAME” to start counting down immediately from 60 seconds:
https://timercheck.io/YOURTIMERNAME/60
You may click on that link now, or hit a URL of the same format with
your own timer name and your chosen number of seconds. You may use a
browser, a command like curl
, or your favorite programming language.
2. Poll timer - The following URL requests the status of the above
timer. Note that the only difference in the URL is that we have
dropped the seconds count.
https://timercheck.io/YOURTIMERNAME
If the named timer is still running, TimerCheck.io will return HTTP
Status code 200 OK
, along with a JSON structure containing
information like how many seconds are left.
If the timer has expired, TimerCheck.io will return an HTTP status
code 504 Timeout
.
That’s it!
No, really. That’s the entire API.