The best way to understand an API is by diving in and seeing working examples in action, so that's what we're doing here. Each API call that we expose can be clicked on in the browser and executed in real-time. If you're new to JSON development, you may want to look at some plug-ins to make viewing JSON in a browser easier - see some suggestions here.
If you have a specific request, either for a feature or for a language/API, let us know. Or, feel free to write up some tutorials yourself. We'll link to them from here or incorporate them into this site.