This application is a sample to showcase the usage of the Box AI API.
- Create a Box free account if you don't already have one.
- Complete the registration process for a Box developer account.
- Making sure you're logged in navigate to the Box Developer Console. This will activate your developer account.
- Create a new Box application. Select Custom App, fill in the form and then click Next.
- Select User Authentication (OAuth 2.0) and then click Create App.
- Scroll down to Redirect URIs and add the following redirect URI:
- http://127.0.0.1:5000/callback
- (or whatever you have configured in the .env file)
- Check all boxes in application scopes.
- (or only what you think will be necessary)
- Click Save Changes.
- Note the Client ID and Client Secret. You will need these later.
You will need to have python installed on your machine.
Get the code
git clone [email protected]:barduinor/box-ai-api-sample.git
cd box-ai-api-sample
Set up your virtual environment
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
Create your local application environment file
cp .env.sample .env
Open the code in the code editor of your choice.
code .
Update the CLIENT_ID and CLIENT_SECRET field values in the env file with the Box application client id and client secret you created on the developer console.
There are 4 samples in this application:
Enjoy
python sample_single_item_qa.py
The first time you run the application, it should open a web browser window and prompt you to log in to Box. After you log in, it will ask you to authorize the application. Once this process is complete you can close the browser window. By default the sample app prints the current user's name to the console, and lists the items on the root folder.
The authorization token last for 60 minutes, and the refresh toke for 60 days. If you get stuck, you can delete the .outh.json file and reauthorize the application.
If you get stuck or have questions, make sure to ask on our Box Developer Forum