First off, go and sign up to get an API key so that you can use the service. Second, take a look at the documentation on the methods available. After that, it is as simple as making a GET/POST request (w/ SOAP if you prefer) in the correct format for the method.

I’ve left all the API Key’s to run with unlimited requests. However, if the this gets popular I will obviously need to throttle those that are beating heavily on the server. So it is probably not a generally good idea to put your API key in your JS source, even though the service won’t care either way. Doing so would give the ability for anyone to make requests against the server in your name with full access to your channels, etc.

Let me know your thoughts!

Update: I’ve updated the service links to a new C# web service.

So, why this ramble? Well, obviously you are bored, hopefully with a friend who is also bored, because who doesn’t like a give a good old fashion ass whooping Battleship style?! I’ve made an early prototype of a game I will be releasing in the next few months leveraging exactly these features and those of jQuery and jQueryUI. Check it out here. Go ahead…try the page on your Wii or any mobile phone that supports mouse dragging. I think you’ll see that the system is much more responsive than the fully AJAX ideas like SinkMyShip.

I’ve already got ideas on the table to expand the classic game to include random terrain generation, harbor defense mechanisms, “big guns”, and special effects to ensure nothing survives your strategic assault. Should you feel so inclined, everyone is welcome to make any suggestions for a super crazy battleship-like turn-based game as well and I’ll see what I can do about incorporating them in to the final version. Happy hunting!