Getting Started
Here's a couple of things you want to do before building your first Autodesk Platform Services application.
Create an account
If you don't have an APS account yet, sign up for one on https://aps.autodesk.com.
You can take advantage of a trial subscription that is valid for 3 months.
Create app credentials
In order to authenticate ourselves to the APS platform, we will need to generate app credentials (specifically, a client ID and client secret) for our application. After logging into the developer portal, go to your profile menu in the top-right corner, and click on Applications:
Next, click on the Create application button:
Enter the name of your application. Select the type of application that applies to you, and click the Create button:
And your application is now ready. Let's store your Client ID and Client Secret credentials as we will need these soon!
Finally, set the Callback URL under General Settings to http://localhost:8080/api/auth/callback
,
and enable the APIs you want your application to have access to. Unless you have any specific reason
for limiting your application's access to the different services, enable everything.
Pay close attention to the Callback URL. This is the address your application's
users will be redirected to after logging in with their Autodesk credentials. It can be
any arbitrary URL but it has to match exactly the URL your server application expects.
In our tutorials we will always use the same address: http://localhost:8080/api/auth/callback
.
Finally, update the application by clicking on the Save changes button, and you're all set!
Provision access in other products
In certain cases it is possible for your application to integrate with other APS-based products such as Autodesk Construction Cloud, or Autodesk BIM 360. We leverage this capability in the Hubs Browser and ACC Administrator tutorials where you can learn about accessing designs from Autodesk Docs, BIM 360 Docs, or Fusion Teams.
However, some of these products must provision access for a specific APS application based on its client ID. Follow the steps below for any specific product you would like to integrate your application with.
If you are not planning to integrate your application with other products for now, you can skip the rest of this page and come back to it later when needed.
- Autodesk Construction Cloud
- Autodesk BIM 360
- Autodesk Fusion Team
Make sure you have admin access to an Autodesk Construction Cloud (ACC for short) account
- Log into your ACC account, and navigate to Account Administration
- From the overview of projects
- From the user interface of a specific project
- On the Account Admin page, go to Custom Integrations, use the Add Custom Integration button on the top to add a custom integration.
- On the Add custom integration dialog page, fill out the Client ID, Custom integration name and Description fields.
- When ready, hit the Add button
After completing the process, your application will be able to use different APS services such as Data Management API or ACC API to access information from all projects under this ACC account.
Make sure you have admin access to a BIM 360 account.
Log into your BIM 360 account, and navigate to Account Admin
On the Account Admin page, go to Settings, and navigate to the Custom Integrations tab
Use the Add Custom Integration button on the left side to start a simple wizard that will guide you through the process
On the Select Access page, keep both the BIM 360 Account Administration and the Document Management options checked, and hit the Next button
- On the next page of the wizard, choose the I'm the developer option, and hit the Next button
Here we assume that the account admin is also the owner of the APS application. If that is not the case, the account administrator can use the Invite a developer option instead, and the invited developer will input the APS application details later.
- On the next and final page, make note of the BIM 360 Account ID, check the checkbox next to it, and fill out the Client ID and the App Name fields exactly as they appear in your application's page on https://aps.autodesk.com/myapps
Consider storing your client ID somewhere in App Description. The client ID will not appear in the custom integration after it has been created, and if the number of integrations in your account starts to grow, this will help you quickly identify the APS application each custom integration is associated with.
- When ready, scroll down and hit the Save button
And that's it. Now your application can use different APS services such as Data Management API or BIM 360 API to access information from all projects under this BIM 360 account.
No provisioning steps are needed. Your APS application can automatically access the data of your authenticated users in this product.