How to register an app

In order to integrate BioDigital Human models into your website or application via our Viewer API, Content API, iOS SDK, or Android SDK, you first need to register an app (i.e., your domain or application) in your BioDigital Human developer account. This step will generate a unique developer key and developer secret. (Learn more at Why do I have to register an app?)

To register an app in your developer account:

1. Click on the Account tab in the upper-right corner of the page, and select Manage Apps from the drop-down menu.

2. Under Manage Apps, you'll see

3. Click on the Add an app button on the right.

3. Under Platform, select "Web Widget" for Viewer API or Content API integrations, "Mobile Widget SDK for iOS" for iOS integrations, or "Mobile Widget SDK for Android" for Android integrations.

4. Enter your app's Name (only you will see this), and domain(s)¹ or bundle ID(s)² where you will be loading your BioDigital Human models. Note: Our validation service will check for a match between your developer key and your domain(s) or bundle ID(s), so make sure you include all testing/staging and production domain(s)/bundle ID(s) where you plan to load models.

5. Click on the Edit icon to find your app’s developer secret. If you're using our Content API or Mobile SDKs, you’ll need this later to access models saved to your Dashboard.

¹Domains can be either a site URL (e.g., www.mydomain.com) or a single IP address (e.g., 192.168.0.1). If you wish to host the widget under a localhost domain, enter the following IP address: 127.0.0.1. You may enter up to 300 domains per app.

²The bundle ID(s) for your iOS or Android mobile app that will be using the BioDigital Human iOS or Android SDK. The bundle ID will be a string, such as "com.biodigital.myapplication." You may enter up to 15 bundle IDs per app.