jplazes - java API for plazes.com
what is jplazes ?
jplazes is a thin java wrapper around the plazes.com APIs. It wraps the XML RPC calls and provides a java interface for most of the methods offered by plazes.
what can it do ?
Currenty plazes.com offers three slightly different APIs: plazer, plazes and whereami.
The offer similar functionalities with some overlap but different signatures… a newer, slimmed down and cleaned up API is to be released (no ETA for this though). Right now the full plazes and whereami API is supported and just a little bit of plazer for MAC OS X and Windows (i would not rely on it…it is still verry beta). plazer API is the one calculating network keys from MAC addresses, needs to find Gateways and so on which is not (yet) supported in native java.
downloads
There are two downloads of jplazes: with dependencies (apache XML-RPC libraries) and without.
- jplazes with dependencies (current version 0.21)
- just jplazes (current version 0.21)
- jplazes with dependencies (previous version 0.20)
- just jplazes (previous version 0.20)
how to
- Get an account with plazes.com, get a plazes API key, get a plazer API key (yes, they are different…but to start with you can just register for the plazes API key). The plazes API key you can get from the plazes.com website while you need to request the plazer API key by email. This is a bit complicated…
- put a jplazes.properties on your classpath. Following keys are required: username, password, plazes.apikey. The plazer.apikey is only required when you want to use the plazer API (suprise,suprise-…)
- run one of the examples in ch.downside.jplazes.examples
help
I know this “documentation” is quite sparse. But jplazes is simple… so just try it. If you have troubles you can reach me at pascal at downside dot ch