コンテンツへスキップ

APIトークンとサンドボックスライセンス

83回閲覧 · 更新日 Nov 22, 2026

作者は、製品にライセンスチェックを組み込むための2つのツールを利用できます。1つは、あなたのアカウントとして AppTrovo API へのリクエストを認証する APIトークン、もう1つは、購入者がキーを持つ前に、ライセンス認証の流れ全体を自分のマシンで試せる無料の 開発者テストライセンス です。

APIトークン

トークンが必要な場合

ライセンス認証エンドポイント(/api/v1/licenses/verify)は公開されています。製品が購入者のキーを確認する際にトークンは必要ありません。トークンは、アカウントが所有するライセンスの一覧取得(/api/v1/licenses)や、/api/v2/author/ 以下の自分の作者データの読み取りなど、API の認証が必要な部分で使用します。

トークンはあなたのアカウントとして動作します。販売する製品、公開リポジトリ、クライアントサイドのコードにトークンを含めないでください。トークンを入手した人は誰でも、あなたとして API を呼び出せてしまいます。

トークンを作成する

  1. 作者アカウントにログインした状態で /author/api-tokens にアクセスします。
  2. 新規トークンを作成 で、トークンの用途がわかる トークン名(例:「ビルドサーバー」)を入力します。
  3. トークンを作成 をクリックします。
  4. 緑色のボックスに表示されたトークンをすぐにコピーしてください。トークンは二度と表示されません。安全な場所に保管したら、閉じる をクリックします。
トークン名フィールドとトークンを作成ボタン、「APIトークンはまだ作成されていません。」と表示されたトークン一覧セクション、認証リクエストとヘッダーの例を示すAPI使用状況ボックスがあるAPIトークンページ
作者パネルの APIトークンページ。

トークンは Authorization: Bearer ヘッダーで、Accept: application/json とあわせて送信します。

トークンの管理と取り消し

トークン には、すべてのトークンが名前、作成日、最終使用日時(または「未使用」)とともに表示されます。同時に保持できるトークンは最大10個です。トークンに有効期限はないため、不要になったものは取り消してください。取り消し をクリックして確定します。取り消したトークンはすぐに使えなくなります。トークンが漏洩した可能性がある場合は、取り消してから新しいトークンを作成してください。

SDK サンドボックスライセンス

サンドボックスを使うと、製品を作成する前にライセンス認証をテストできます。スラッグが apptrovo-sdk-sandbox の共有サンドボックス製品用の開発者キーが発行されます。

  1. /author/sandbox-license を開きます。まだ製品がない場合は、作者ダッシュボードにも サンドボックスライセンスを取得 ボタンが表示されます。
  2. 生成 をクリックします。キーがコピーボタン、有効期限、使用中のドメインスロット、製品スラッグとともに表示されます。
  3. キーの下に表示される クイック動作確認 のコマンドをコピーします。1つ目の domain=localhost を使うコマンドは "valid": true を返すはずです。2つ目の公開ドメインを使うコマンドは拒否される必要があります。
  4. インストーラーの設定をサンドボックスのスラッグに向け、認証のシナリオを一通り試します。
許可されたローカルドメインの一覧と生成ボタンがあるサンドボックス開発ライセンスのカード、その下に黄色の「自分の製品をリリースするとき」の注意書きとライセンス統合ガイドへのリンクがあるSDKサンドボックスライセンスページ
SDK サンドボックスライセンスページでサンドボックスキーを生成します。

自分の製品用の開発者ライセンス

製品を作成したら、その製品で直接テストします。

  1. マイ製品 を開き、製品をクリックして詳細ページを開きます。
  2. 開発者テストライセンス カードを探し、生成 をクリックします。
  3. カードからキーと製品スラッグをコピーし、クイックテスト のコマンドで動作を確認します。

リリースする際は、インストーラーの設定にあるサンドボックスのスラッグを実際の製品スラッグに置き換えます。それ以外の統合部分はそのままで構いません。

開発者ライセンスのルール

サンドボックスライセンスと製品ごとの開発者ライセンスは、同じように動作します。

  • 認証できるのはローカルのホスト名のみです:localhost、127.0.0.1、::1、および .test、.local、.localhost で終わる名前。実在のドメインは拒否されるため、本番環境では使用できません。
  • すべてのチェックに domain パラメーターを含める必要があります。
  • 各キーには5つのドメインスロットがあり、有効期間は30日間です。同じカードの 30日延長 をクリックすると、有効期限が延長されます。キーは変わりません。
  • 開発者ライセンスは製品ごとに1つです。再度生成すると、新しいキーは作成されず、既存のキーの期限が延長されます。
  • 認証レスポンスでは "license_type": "developer" と "is_dev": true が返されるため、コード側でテスト用キーを区別できます。

よくある質問

サイドバーに APIトークンが表示されないのはなぜですか?

現在、このページにはメニュー項目がありません。/author/api-tokens をブックマークしてください。

開発者キーで「License has expired」と表示されます

キーを作成したカードを開き、30日延長 をクリックしてください。同じキーが再び使えるようになります。

関連記事

この記事は役に立ちましたか?