*Important* Foursquare API versioning changing from oldest-by-default to newest-by-default on Nov. 7th

[Akshay Patil]

Hi everyone,

A few months ago, we added versioning to our API. By specifying "v=YYYYMMDD" in your API requests, you can "freeze" a version our API in your application to protect from future breaking changes. When not specifying the versioning param, we defaulted to our oldest supported behavior, as an effort not to break existing apps.

https://developer.foursquare.com/docs/overview.html#versioning

In a month (11/7), requests not specifying a version parameter will start receiving the newest version of our API instead of the oldest supported behavior. This will allow us to better track third-party reliance on deprecated behavior and more aggressively remove outdated code.

If you are not versioning your API calls by November 7th, you will see a number of breaking changes in API responses on that date. We highly highly highly recommend specifying the latest appropriate API version in all your foursquare API requests. Our API is constant changing as we polish endpoints and launch new features; versioning is a critical tool for insulating your app from these future changes, allowing you to update code according to your release schedule and not ours.

Cheers!

~ak
--
Akshay Patil / Foursquare Platform Evangelist
@akdotcom / @foursquareapi

[Akshay Patil]

Reminder -- this is happening in a week! Be sure to switch your apps over to make versioned requests from the foursquare API, otherwise your app will be prone to breakage on that date and in the future.

~ak

[Akshay Patil]

Hacker bums,

Due to the appallingly large number of non version-protected requests we're still seeing to our API, we've pushed back this change for a little while.

We will start returning prominent warnings on all endpoints for non-versioned requests tomorrow and we WILL make this change in the not too distant future. PLEASE help us avoid breaking your application in the near future and start making versioned requests ASAP!

~ak