Field API: Updating a Equipment Creates a Duplicated Record

Q. I’m trying to update an existing equipment record. By calling /api/equipment, however, I end up creating a new record with the same values.  I used /api/get_equipment to get an equipment record, and using /api/equipment to update. What do I need to do to update an existing record?

A. Please check your JSON string representing a record and make sure that you are using “id” and not “equipment_id”. For example, if your equipment ID in JSON data looks like this:

[{“equipment_id“:”a9df893e-d9b9-4098-b434-e7d2be62d0a8”, …

then, you will need to modify it to:

[{“id“:”a9df893e-d9b9-4098-b434-e7d2be62d0a8”, …

Continue reading “Field API: Updating a Equipment Creates a Duplicated Record”

Advertisements

Forge Subscription FAQ

I’m not an expert of sales side of discussion. Still, questions like “does ADN membership include Forge subscription?” comes to me occasionally. Forge subscription model itself has evolved since the DevCon last year. There are a few things that I myself wasn’t sure and needed to ask. So here I’m sharing a few questions and answers that I happen to have received recently. These are supplemental to the information that are described on the official Forge pricing page: https://developer.autodesk.com/en/pricing

Disclaimer: the information written here is from the best of my knowledge at the time of this writing (2/4/2017). There may be some changes coming in future. Please check the latest on the official pricing page, and use “Contact Forge Sales” button found at the bottom of that page for more information.    

Continue reading “Forge Subscription FAQ”

HQ API: Get Companies Under a Specific Project

The latest update for HQ includes an API enhancement; you can get a list of companies that are related to a specific project. The documentation is found here:

GET projects/:project_id/companies

In UI, you can find corresponding information under Project icon >> {a_given_project} >> Companies tab (see the image below).

I just gave it a try. Nothing complex. But thought keeping some snapshots (while I have it at hand) might help understand what this functionality is about more easily.

Continue reading “HQ API: Get Companies Under a Specific Project”

BIM 360 Docs API Update

I’m happy to inform you that the latest update for Forge Data Management (DM) includes important enhancements for BIM 360 Docs support; you can upload a file now (y). The documentation page is updated to include Docs. I myself have been waiting for this for a long time. While we are aware that this is not complete, this is a big milestone. Here is a quick summary of the current status of DM support for Docs.

Key Points

Basic workflow is identical to A360 Personal Hubs and BIM 360 Team (as well as Fusion Team). A few differences are:

  • Docs support 2-legged and 3-legged.
  • “Hubs” is equivalent of “Accounts” in BIM 360.
  • Docs requires an additional step for provisioning or activating API access in HQ.
  • Look for the use of extension types, such as *:autodesk.bim360:* instead of *:autodesk.core:*

API Basics page describes extension types and data management services in detail.

Continue reading “BIM 360 Docs API Update”

3-Legged Authentication Using Postman

Continuing from the previous post about 2-legged authentication, let’s take a look at 3-legged authentication or more precisely OAuth 2.0 3-legged authentication with Forge next. My colleague, Adam Nagy, has already written a blog post about calling 3-legged using Postman. My rewrite will be with additional comments with BIM 360 in mind.

BIM 360 Team and Docs support 3-legged. HQ does not.

Prerequisite:

Continue reading “3-Legged Authentication Using Postman”

2-Legged Authentication Using Postman

I mentioned about Postman being a useful tool for learning and troubleshooting a few times in the past. As multiple language choices exist to make REST API calls (i.e., NodeJS, php, Ruby, ASP.NET, etc.), let’s start with Postman to get a feel of the workflow to make calls with Forge API.

As I mentioned in my earlier post, there are two types of authentication methods for Forge: 2-legged and 3-legged. Let’s start with 2-legged as it is less complex in terms of make a REST call.

Continue reading “2-Legged Authentication Using Postman”