mixiアプリAPI新方式移行手順
技術仕様(新方式)を読んでから、本ページをお読み下さい。
現在、PC版、モバイル版、スマートフォン版(iOSアプリ版、Androidアプリ版は除きます)でご利用いただいているmixiアプリAPIはRESTful APIをベースとしたもの(以後「旧方式」と呼ぶ)を利用して頂いておりますが、今後mixiとしてはGraphAPIをベースとしたもの(以後「新方式」と呼ぶ)にシフトしていきます。今後新機能は新方式に優先的に追加していき、旧方式のものには基本的に追加は行いません。開発者の方々には、新方式で利用できる新たな機能を生かしてmixiアプリをより良いものにしていただければと思います。
新方式への移行手順
新方式への移行については二つのステップが存在します。
- 新方式で利用するConsumer KeyとConsumer Secretを発行する
- 各デバイスに対して新方式の移行申請を行なう
以下、この二つのステップについて説明していきます。
1.新方式で利用するConsumer KeyとConsumer Secretを発行する
これからアプリを新規作成する方は一度アプリ作成画面において必要項目を入力して保存してから次の手順に進んで下さい。
アプリ設定画面において以下の画像のようなボタンが配置されていますので押下して下さい。ここで申請することにより新方式のAPIで利用するConsumer KeyとConsumer Secretが発行されます。
以下の画面において申請内容を確認していただき、新方式利用時に表示する認可画面における認可完了後のリダイレクト先のURIを設定し、「同意して申請する」ボタンを押下して下さい。
これによりアプリ設定画面に以下の画像のような項目が追加され、新方式のAPIで利用するConsumer KeyとConsumer Secretが確認できるようになります。
2. 各デバイスに対して新方式の移行申請を行なう
ここではPC版を例にとって説明します。他のデバイスで利用したい場合は各デバイスでそれぞれ申請を行なって下さい。
新方式で利用するConsumer KeyとConsumer Secretを発行が完了すると各デバイスの設定項目に以下画像のような項目が追加されます。「新方式にAPIを切り替える」ボタンを押下して、申請を行なって下さい。この申請を行なうことによって各デバイスにおいて新方式のAPIを利用する事が可能となります。
以下の画面において申請内容を確認していただき、PCアプリを起動した時のスタートURLを設定し、「同意して申請する」ボタンを押下して下さい。この時にチェックボックスにチェックを入れるのを忘れないで下さい。1度新方式に切り替えてしまうと旧方式に戻すことができませんので慎重に操作をお願いします。新方式に切り替えたからといって旧方式が利用できなくなることはありませんが、切り替え後は速やかに新方式APIのみを利用するようにして下さい。
結果、完了画面が表示されます。
以後mixiアプリPC版において新方式のAPIが利用可能となります。
他デバイスでも同様に移行作業を行なって下さい。
新方式への移行テスト方法
新方式に移行するための支援機能として、旧方式の状態で新方式を試用するオプションを提供しています。
以下にその手順を解説します。
1.新方式のスタートURLを登録する
新方式で利用するConsumer KeyとConsumer Secretの発行が完了している段階で、新方式を試用したいデバイスの「スタートURL(新方式)」を登録します。
2.アプリ実行時のURLにパラメータを付ける
この状態で、アプリ実行時のURLに以下のパラメータを付与することで新方式として動作します。
connect_view=1