Welcome to the Web Servery!


POST stuff here and you get XML back

This is a collection of web services that I use in my projects. Most of them are for things that require ongoing maintenance... eg the public holidays of Australia are decided on an ad hoc basis by our crazy politicians so they can't be predicted, we just have to wait for them to be handed down. I'll probably keep them up to date. If you want to use these services in a project with a long lifespan and you want to make sure the service stays available, contact me and we'll work something out. You could drip feed me some money, but I'm very open to more creative options too.
All the services here follow a standard API pattern. You send them a POST via http and get back an xml document. Your POST will need to include parameters a0,a1,a2,a3 etc. The number of parameters and their meaning varies from command to command. The returned xml document will contain nodes b0,b1,b2,b3 etc. Some conventions are maintained. a0 will always be a command. a1 will always be a user identifier (username or email address). a2 will always be a user password. b0 will always be an error code which represents the success or failure of the requested action. b1 will give further explanation of the b0 code. b0 codes will be as follows
Code Name Meaning
200 SUCCESS Command completed succesfully
400 SYNTAX_ERROR POST was missing a required parameter, or a POSTed parameter is outside allowable bounds.
401 PERMISSION_ERROR Not authorised for requested action
402 INSERT_COINS Payment is required for the requested action
403 STATE_ERROR Action could not be completed due to state of existing data (b1 should provide further explanation)
500 SNAFU_ERROR Internal error, not expected to occur. Ever.
503 HOLIDAY_ERROR System is down for maintenance, we know there's a problem and we are working to fix it.
Each service will provide an "API playground" with a URL like http://www.webservery.com/services/public_holidays/test.php where you can see the documentation and play with the API to see how it works

Australian Public Holiday Checker

If you need to know whether a particular day is a particular holiday in a particular Australian state, send the day and state to this service and get an answer back like "NORMAL", "SATURDAY", "SUNDAY", "QUEEN'S BIRTHDAY", "LABOUR DAY". Currently free, very likley to remain free. If you want this for a particular project and need a service-level agreement, contact me, it can be done! australian public holidays - API Playground

and a cool example of the output See upcoming holidays

Bank Statement Madness

Helps you work out what that cryptic and suspicious transaction on your credit card or bank statement actually means

Bank Statement Madness

email me! scottbattersby@gmail.com

Useful Crap

How to make an A4 sheet fit into a DL Window Envelope