Twitter アカウントとの連携

Twitter アカウントを用いたユーザー作成・ログインは、開発者ポータル上でアプリケーションの設定を行うだけで簡単に実現できます。

Twitter との連携設定

Twitter アプリケーションの作成

まずは、Twitter アプリケーションを作成し、Twitter Consumer Key と Secret を取得する必要があります。取得方法の詳細については こちら を参照してください。

Twitter アプリケーション作成の際には、以下の情報が必要です。なお、${your-app-id} にはご利用の AppID を入力してください。

  • Name
  • Description
  • Website
  • コールバック URL
    • アメリカ合衆国:https://${your-app-id}.us.kiiapps.com/api/apps/${your-app-id}/integration/webauth/callback
    • 日本:https://${your-app-id}.jp.kiiapps.com/api/apps/${your-app-id}/integration/webauth/callback
    • シンガポール:https://${your-app-id}.sg.kiiapps.com/api/apps/${your-app-id}/integration/webauth/callback
    • ヨーロッパ:https://${your-app-id}.eu.kiiapps.com/api/apps/${your-app-id}/integration/webauth/callback

Twitter アプリの作成が完了すると、Twitter Consumer Key と Secret が払い出されます。

Kii アプリケーションの設定

次の手順に従い、開発者ポータルより Twitter Consumer Key と Secret の登録を行います。

  1. アプリケーションコンソール上で "Edit" ボタンをクリックします。

  2. "Setting" をクリックしアプリ設定画面を開きます。

  3. Twitter Consumer Key と Secret を設定します。

Twitter よりアクセストークンを取得

アクセストークンの取得は自前で行う必要があります。Twitter のアクセストークンを自前で取得する方法については こちら を参照してください。

Twitter アカウントによるログイン

Twitter アカウントを用いて Kii Cloud にログインする例を以下にあげます。{ACCESS_TOKEN_PROVIDED_BY_TWITTER}{ACCESS_SECRET_PROVIDED_BY_TWITTER} には、それぞれ取得した Twitter のアクセストークンとトークンシークレットを入れてください。

curl -v -X POST \
  -H "Authorization: Basic {BASE64_ENCODED_APPID_AND_APPKEY}" \
  -H "Content-Type: application/vnd.kii.AuthTokenTwitterRequest+json" \
  "https://api-jp.kii.com/api/apps/{APP_ID}/integration/twitter" \
  -d '{
    "accessToken": "{ACCESS_TOKEN_PROVIDED_BY_TWITTER}",
    "accessTokenSecret": "{ACCESS_SECRET_PROVIDED_BY_TWITTER}"
  }'

ログインは Basic 認証 を使って行います。{BASE64_ENCODED_APPID_AND_APPKEY} には AppID と任意の値をコロン(:) で連結した文字列を Base64 エンコードしたものを入れてください。

指定されたアカウントが新規の場合、必要に応じてログイン処理に先立ちユーザー作成処理も同時に行われます。

ログイン処理が成功すると Kii Cloud は以下のような応答を返します。応答には、このユーザーの ID、ユーザートークン、ユーザートークン有効期間(秒)などの情報が含まれます。

< 200
< Content-Type: application/json
<
{
  "id" : {USER_ID},
  "access_token" : {ACCESS_TOKEN},
  "expires_in" : 9223372036854775,
  "new_user_created": true
}

なお、Kii Cloud がユーザー作成処理を行った場合 new_user_created キーが true に設定されます。

Kii アカウントと Twitter アカウントのリンク

すでに存在する Kii Cloud ユーザーを Twitter アカウントとリンクできます。リンクを行うと、このユーザーは Twitter アカウント認証経由で Kii Cloud にログインできるようになります。

curl -v -X POST \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "Content-Type: application/vnd.kii.LinkTwitterRequest+json" \
  "https://api-jp.kii.com/api/apps/{APP_ID}/users/me/twitter/link" \
  -d '{
    "accessToken": "{ACCESS_TOKEN_PROVIDED_BY_TWITTER}",
    "accessTokenSecret": "{ACCESS_SECRET_PROVIDED_BY_TWITTER}"
  }'

アカウントのリンクに成功すると、Kii Cloud は次のように応答を返します。

< 204 (No content)

Kii アカウントと Twitter アカウントのリンク解除

Kii Cloud のユーザーアカウントと Twitter アカウントのリンクを解除する例を以下に示します。

curl -v -X POST \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  "https://api-jp.kii.com/api/apps/{APP_ID}/users/me/twitter/unlink" \
  -d ""

アカウントのリンク解除に成功すると、Kii Cloud は次のように応答を返します。

< 204 (No content)