Gowalla Officially Released Write API, the Right Way

Adam DuVander, August 6th, 2010

GowallaGowalla said a writeable API was coming soon. Today, the check-in API is available to developers. Though it took longer than anyone expected, the announcement and the API have some nice aspects to help developers use the new features.

API Guidelines

Along the the announcement of the API, Gowalla provided guidelines for its use. These best practices help explain why Gowalla was hesitant to have a check-in API and also communicate a set of values to developers, which could be useful within any community. From the developer announcement:

  • Encourage users of your application to check in at places they are actually located.
  • Avoid incentives or game mechanics that reward checking in from distant locations.
  • Never “auto check-in” a person without their explicit permission. This is seriously uncool.
  • Encourage social interaction over bot-like behavior.
  • Rapid, repeated check-ins with the intent to automate the location and swapping of items will not be tolerated.
  • Go easy on the API. Cache data where you can, respond to error messages, and be thoughtful about your user experience.
  • Applications that disregard the guidelines above risk violation of Gowalla’s Terms of Service and may have their API access suspended without warning.

Example App (with Code)

Rather than just turn developers loose to the documentation, Gowalla provides an example app. You can demo it and even download the code. Providing working examples can jumpstart a developer’s work. It also helps reinforce the guidelines by showing the best practices in action.

Sandbox for Testing

Getting an app just right requires a lot of testing. When each test is a write to a live system, that sullies the data (and with the case of check-ins, could annoy your friends). Gowalla provides a special endpoint of the API just for testing check-ins.

The above doesn’t even mention the thorough documentation, complete with full JSON response. With these excellent examples of an API launch, we find ourselves almost forgetting how long developers have requested this feature from Gowalla.

Both comments and pings are currently closed.

4 Responses to “Gowalla Officially Released Write API, the Right Way”

August 7th, 2010
at 5:20 pm
Comment by: This Week In Location: 28 Location-based articles you may have missed to stay current in the location space | Wayne Sutton - location-based services, gadgets, marketing, social media, iPhone & iPad

[...] Gowalla Officially Released Write API, the Right Way [...]

August 7th, 2010
at 5:49 pm
Comment by: This Week In Location: 29 Location-based articles you may have missed to stay current in the location space | Wayne Sutton - location-based services, gadgets, marketing, social media, iPhone & iPad

[...] Gowalla Officially Released Write API, the Right Way [...]

August 29th, 2010
at 4:58 am
Comment by: What’s next for ‘check-in’ apps? « World Hot News

[...] up recently or may do so in the near future. Gowalla, one of Foursquare’s direct competitors, opened its code up for developers this [...]

August 29th, 2010
at 6:15 am
Comment by: What’s next for ‘check-in’ apps? » Master Jailbreak

[...] in the near future. Gowalla, one of Foursquare’s direct competitors, opened its code up for developers this [...]

Follow the PW team on Twitter

ProgrammableWeb
APIs, mashups and code. Because the world's your programmable oyster.

John Musser
Founder, ProgrammableWeb

Adam DuVander
Executive Editor, ProgrammableWeb. Author, Map Scripting 101. Lover, APIs.