Box Developerドキュメント

最初のアプリケーションの作成

ガイド はじめに 最初のアプリケーションの作成

最初のアプリケーションの作成

開発者用エンタープライズを設定したら、アプリケーションの作成を開始できます。

開発者用エンタープライズにログインしたら [開発者コンソール] ボタンをクリックします。これが最初のアプリケーションである場合は、利用開始を促すメッセージが表示されます。

アプリケーションの種類の選択

まず、作成するアプリケーションの種類を選択します。このガイドでは、[カスタムアプリ] オプションを使用します。ほとんどのパートナーが統合にこの種類を使用しているからです。

認証方法の選択

[カスタムアプリ] を選択したら、アプリで使用する認証方法を選択する必要があります。このガイドでは、[ユーザー認証 (OAuth 2.0)] オプションを使用します。ほとんどのパートナーが統合にこの種類を使用しているからです。

アプリの命名

アプリの名前を選択します。名前は後から変更でき、アプリを公開するまで他の人の目に触れません。アプリの名前はアプリを公開すると管理者やお客様に表示されるため、わかりやすい名前を選択することをお勧めします。

[アプリの作成] ボタンをクリックしてアプリの作成を完了します。次に、アプリケーションの設定を構成します。

一般設定

最も基本的な設定から始めます。[一般設定] タブを開き、以下のフィールドでチェックボックスをオンにしたり、入力したりします。

  • [アプリ名] - アプリ作成時に設定する名前。ここで必要に応じて変更できます。
  • [連絡先メール] - デフォルトでアプリケーションの開発者のアドレスに設定されます。アプリを公開すると、統合でアプリを表示したBoxユーザーにこのアドレスが表示されることに注意してください。統合に問題があった場合にユーザーがサポートに連絡できるよう、サポートのメールアドレスに変更することをお勧めします。
  • [コラボレータ] - この統合の作成に取り組むことができる他の開発者を追加します。追加された開発者は、設定を調整する必要があるときに開発者インターフェースにアクセスできるようになります。

ここに追加する開発者はすでにBoxユーザーである必要があります。Boxアカウントを持っていない場合は、開発者用エンタープライズでアカウントを作成できます。

詳細設定

[構成] タブに移動します。ここでは、アプリの詳細の指定、開発者トークンの生成、OAuth 2.0資格情報の確認、OAuth 2.0リダイレクトURIの追加と編集、アプリケーションスコープの選択、アプリの高度な機能の設定、CORSドメインの追加を行うことができます。

その他のタブでは、Webhookやウェブアプリ統合を作成したり、Enterpriseへのアクセスを有効化するためにアプリを送信したり、Box統合にアプリを送信したり、このアプリケーションのアクティビティを確認できるレポートを生成したりすることができます。

アプリのテスト

APIコールを行ってアプリをテストし、Boxでのレスポンス形式を確認できるようになりました。

現在の開発者アカウントに対して認証された開発者トークンを使用します。

このトークンの有効期限は、生成されてから1時間です。

Postmanコレクションから始めて、特定のコールを確認し、返されるレスポンスを確かめます。APIコールの例については、APIリファレンスドキュメントを参照してください。ターミナルを使用したい場合は、Box CLIツールを使用することもできます。