Checkin API
You can check in with any system that can send an http request
The base address is:
https://api.IsItWorking.info/c/CHECKIN_IDENTIFIER
If the checkin is succesful, then you will get a 200 response with an empty body
Optional Parameters
You can send parameters either as post variables, or as url-encoded parameters
s - Status of your script
m - Message
t - Time it took your script to run
b - Boundary - max allowed time for your script
Status - s
s You can send the status in s. This is typically used to capture the output of your script. This is converted to an integer, then any integer value other than 0 (zero) is considered as an error.
If an error is recieved, you will be notified immediately
This allows you to trigger a notification without waiting for the timeout
E.g. to trigger an immediate error:
curl -d "s=1" https://api.IsItWorking.info/c/CHECKIN_IDENTIFIER
Message - m
m You can send a message in m. This allows you to provide additional information.
Messages do not trigger notifications.
E.g. to trigger an immediate error, and provide information on the failure reason
curl -d "s=1&m=Backup failed" https://api.IsItWorking.info/c/CHECKIN_IDENTIFIER
Timing - t & b
The time t and boundary b fields provide a simple way for you to send the time your script took, as well as a boundary which should trigger a warning
Both time and boundary are converted to integers. If the time value is greater than the boundary value, this is considered as an error - and you will be notified
If you don't provide a boundary value, then no error is triggered, and the time is simply saved
Time and boundary can be in any units you like, depending on your needs (e.g. 10 can mean 10 milliseconds, 10 minutes or 10 hours)
Sending a message in m allows you to provide additional information.
Time and Boundary values can be seen in the checkin history page for your checkin
E.g. if a script took 10 seconds this time, and you want to be warned if it takes more than 30 seconds, you would send:
curl -d "t=10&b=30&m=backupScriptV1" https://api.IsItWorking.info/c/CHECKIN_IDENTIFIER
If a subsequent run takes 40 seconds, then the following would trigger an error:
curl -d "t=40&b=30&m=backupScriptV1" https://api.IsItWorking.info/c/CHECKIN_IDENTIFIER