Here's a trend we're seeing more of these days: vendor provided interactive API tools. These useful web-based applications let you test drive the methods of a given web API without having to write code. AJAX-style web forms let you choose methods and parameters, press go, and have data immediately returned in another part of the page.
Update: Make that 12 interactive tools, see farther below.
This can be a great way for API providers to let developers kick the tires on their APIs and quickly get up to speed. From Facebook to Google to CNET, these tools are becoming more common and more sophisticated.
Here's a rundown of 9 places you can try now:
- Facebook Test Console: If you have a Facebook login you can use the Facebook Test Console. Test over a dozen methods and get responses in XML, JSON, and Facebook PHP Client.
- Interactive Google Base: As they describe "This demo page provides you with a simple mechanism for using the API and learning how it works. Each Google Base data API operation has an equivalent HTTP method, so you can try out the HTTP GET, POST, PUT, and DELETE methods as you invoke the operations below."
- CNET API Dashboard: As we reported last month CNET's new shopping API includes this handy tool. Use it to test getting review, shopping and download data.
- Flickr API Explorer: Try-out methods of the popular Flickr API with this tool. And since you may find yourself looking at an interactive API tool but not have any meaningful data to feed into it - like when it asks you for a "photo_id" - Flickr goes one step farther by offering a list of "Useful Values" on the side of the page including photo IDs and Group IDs. Very helpful feature.
- FollowTheMoney.org: There are a lot of good implementation details in the API for this non-profit, one of which is this AJAX example with download-able source code. For more on FollowTheMoney, see our earlier coverage here.
- Amazon AWS Zone: Test drive eight different Amazon APIs. As they say "Amazon Web Services made simple." Includes code samples, a code generator, REST and SOAP scratch pads.
- Interfax Fax Web Service Demo: Doesn't allow you to try the whole API but gives access to the main SendCharFax method so you can send faxes. ID required.
- MetaCarta JSON API Explorer: Lets you use their mapping data API and get results back in JSON and KML.
As expected, we've heard from readers with more tools for this list:
- Google AJAX Search API Wizards: A set of useful wizards that help you quickly integrate Google's AJAX Search into your site. Wizards for Maps, Video Bar, Video Search, News Bar, Blog Bar, and Book Bar. A form for each walks you through three steps: Customize it, Tell us your site, Generate code.
- Demo Tool for Google SAML Single Sign-On: While not a full-featured tool, this interactive demo of the Security Assertion Markup Language single sign-on service for Google Hosted Services walks you through each step of the reasonably complex process illustrate each step of the SAML workflow between Google and the Partner.
- Here are a pair of Google-provided mapping "playgrounds" where you can use forms to interact with the Google Maps API: GMarkerOptions Playground and GMarkerEvents Playground
If you're aware of others that are not on this list you can share them in the comments.