【foursquare API】2014年6月1日よりv=20120609以前のバージョンが使用できなくなります #4sqdevjp

And here we go: we're officially deprecating API versions 20120609 and lower. Get your upgrade on! https://t.co/Cv6jHTtST4

— Foursquare API (@FoursquareAPI) 2014年2月21日

今朝、foursquareアカウントから公式アナウンスがありました。

• Deprecating Foursquare API Versions 20120609 and Earlier

要約すると、2014年6月1日より v=20120609 以前のバージョンが使用できなくなるようです。

現時点でも 20120609 より前の日付（例えば20120608）を指定すると次のような警告が出ます。

{
    "meta": {
        "code": 200,
        "errorDetail": "This API version will be deprecated soon. Please switch to using an API version v >= 20120609. For more information, see http://bit.ly/IdewPO and http://bit.ly/vywCav",
        "errorType": "deprecated"
    },

何をすればいいの？

2014年6月1日0時までに、v= の値を 20120610 もしくはそれ以降の日付にセットし、なおかつサービスが正常に動作することを確認する必要があります。

対応しないとどうなるの？

2014年6月1日に、次のような仕様変更が実施されます。

1. カテゴリアイコンのデザインが強制的に変更される

これまでのデザイン

が次の新デザインに変更になります。

一見すると真っ白に見えますが、これはアイコンが透過色で描かれているためです。

よって、開発者はアイコンの背景に白以外の背景画像を重ねるなどして、アイコンが正常に表示されるようにする必要があります。拙作アプリ FastCheckin では、灰色の背景にアイコンを重ねるようにしています。

参考：【foursquare】新カテゴリアイコンについて調べてみた - koogawa blog

2. ベニュー検索結果のJSON構造等が変わる場合がある

いつのタイミングかは忘れましたが、ベニュー検索結果のJSON構造が微妙に変わっています。このため、新しいJSON構造に対応しないサービスは、2014年6月1日以降は正常に動作しなくなる可能性があります。（スマートフォンアプリの場合は最悪クラッシュする可能性もあります）

brownoutテスト

2014年5月15日に1日だけbrownoutテストが実施されます。この期間中に 20120609 以前のバージョンを指定するとすべて拒否されます。心配な方は、この機会にサービスが正常に動くことを確認すると良いでしょう。

合わせて読みたい

• 【foursquare】新カテゴリアイコンについて調べてみた - koogawa blog
• foursquare API利用時、バージョンパラメータの指定が必須に - koogawa blog