API設定方法（Apps API）

このページでは、Apps APIを利用するために必要なアクセストークンの取得方法と認証の手順を解説します。

APIを使うための準備

まず、以下の情報を管理画面で確認します。

• アプリID
• アプリシークレット

Appsの管理画面（API設定画面）にログインして取得してください。

アクセストークンの取得方法

アクセストークンを取得するには、以下のコマンド（curl）を実行します。

curl -H "Content-Type: application/x-www-form-urlencoded" \
     -H "Authorization: Basic {Base64エンコードしたAPP_ID:APP_SECRET}" \
     -X POST "https://api.theapps.jp/v1/identity/oauth2/token" \
     -d "grant_type=client_credentials"

{Base64エンコードしたAPP_ID:APP_SECRET} には、
アプリID:アプリシークレット を Base64でエンコードした文字列を入れてください。
成功すると下記のような JSON が返ります。

{
  "access_token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "expires_in": 3600,
  "token_type": "Bearer"
}

取得した access_token を保存し、後続の API 呼び出しで
Authorization: Bearer {access_token} ヘッダーとして利用します。

【補足】Base64エンコード方法

「アプリID:アプリシークレット」をBase64エンコードする必要があります。
以下のサイトなどで簡単に生成できます。

• Base64エンコードツール

【補足】ターミナルで Base64 を生成する例

Mac / Linux

echo -n "APP_ID:APP_SECRET" | base64

Windows PowerShell

[Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("APP_ID:APP_SECRET"))

成功したときのレスポンス例

実行すると、以下のようなJSONレスポンスが返ってきます。

{
 "access_token": "取得したアクセストークンがここに入ります",
 "expires_in": 3600,
 "token_type": "Bearer"
}

• access_token をコピーして保存します。
• expires_inはトークンの有効期限（秒単位）を示します。この例では3600秒（＝1時間）で期限切れとなります。

APIを利用する

取得したアクセストークンを使い、Apps APIにアクセスできます。

以下は顧客情報を取得する例です（顧客情報取得API）。

curl -H "Authorization: Bearer {取得したアクセストークン}" \
     https://api.theapps.jp/v1/customer/{customer_id}

テスト環境（Sandbox）と本番環境

1. 管理画面でテスト用アプリID / シークレットを取得
2. sandbox-api に切り替えて mode=test で動作確認
3. 問題なければ本番 ID / シークレット＋mode=live で運用

テスト用トークンは本番APIでは利用できません。

よくあるご質問