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
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
|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.|
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! firstname.lastname@example.org