Important Note for API Clients

keqingsong — Tue, 12 May 2020 00:39:38 GMT

We just released our May 2020 product update, and we've made some tweaks to the API.

We've put in extra efforts to make Fusion 360's 3D modeling operations even more stable. That required performing stricter validation checks on inputs before performing any operation. Earlier an Add-In could request an operation with some invalid inputs, and Fusion used to accept them and tried to generate (potentially unstable) output if it can. After this update, Fusion 360 will start rejecting such requests and will error out. Unfortunately, that could mean potential breakage of your Add-Ins, if they performed such an operation.

Here's a simple example of what an 'invalid' input looks like:

...

# Sketch circle created with some arbitrary radius 
circle = sketch.sketchCurves.sketchCircles.addByCenterRadius(center, radius)

# Extract sketch profile out of it
profile = sketch.profiles[0]

# Adjust the circle radius
# BAD! Because this will make the 'profile' invalid.
# You should either do this before fetching the profile from sketch, or should re-fetch the profile now
circle.radius = 5
        
# Create sweep (without re-fetching sketch profile)
sweepFeats = feats.sweepFeatures
sweepInput = sweepFeats.createInput(profile, path, adsk.fusion.FeatureOperations.NewBodyFeatureOperation)
sweepFeat = sweepFeats.add(sweepInput)

...

This used to work fine earlier as Fusion 360 was forgiving. But as this could lead to instabilities down the road, the sweep operation will fail from now on. This is just one example of many ways to make something invalid. Add-In authors would be the best judges of how it affects their scripts.

If you're an Add-In author and need any assistance with this, please don't hesitate to reach out to us

Re: Important Note for API Clients

OceanHydroAU — Tue, 12 May 2020 06:57:45 GMT

Thanks for letting us know. Could you spare a moment to tell me if it's possible for our API to "hook in" to change events (e.g. updated user parameters)? I've described it here:

https://forums.autodesk.com/t5/fusion-360-api-and-scripts/add-in-user-parameter-driven-results-is-this-possible/td-p/9484832

Re: Important Note for API Clients

kandennti — Wed, 13 May 2020 14:26:04 GMT

I am sorry that I wrote a cheeky matter.

I feel that the fact that I don't know whether getting a property is "deep copy" or "shallow copy" is a misleading reason.

Also, the method called "copy" is similar. Deep copy is easy to understand if you give it the name "clone".

Re: Important Note for API Clients

marcinszydlowski.1984 — Fri, 15 May 2020 06:26:41 GMT

Thanks for the info @keqingsong

topic Important Note for API Clients in Fusion API and Scripts Forum

Important Note for API Clients

Re: Important Note for API Clients

Re: Important Note for API Clients

Re: Important Note for API Clients