Asset TutorialΒΆ

This is the Assets and Asset versions module. We can now treat our model as a project that will be improved over time. With that being said an Asset is the overall project and an asset version are improvements that you will be making. This is very similar to a Version-Control for your model. So first we will create an Asset for a particular base model then we will create improvements to this by creating an Asset Version and then finally we can look at our Asset and see all the changes we made and if we want more information we can look into a particular Asset Version for more information on a change.

Starting off you will want to have a model uploaded and a session or API token in order to create a asset for your model.

image of normal cube

So once you have that we can create a payload containing our model and the name of the asset we wish to create.

POST https://models.authentise.com/asset/
Content-Type: application/json

{
  "name"  : "My Model 1.0",
  "model" : "https://models.authentise.com/model/aed631aa-f7b2-46dc-964d-ecbe3bca4c19/",
}

So now lets change our model in someway and create a new asset-version for the updated model.

image of normal cube

Now that we have our Asset created and a new version of our model we can now create a new asset version that will tie our old model to our new one.

POST https://models.authentise.com/asset-version/
Content-Type: application/json

{
  "name"            : "My Model 1.1",
  "message"         : "Reduce height by 5mm",
  "new_model"       : "https://models.authentise.com/model/7d6079e2-f071-4057-9fe1-35e10980835c/",
}

Awesome we now have an asset for our model and a version to go along with it. Lets try using this to see all the changes we’ve made to our model we will be doing a GET on the asset endpoint which will return a list of the asset-versions we’ve created.

GET https://models.authentise.com/asset/uuid/
Content-Type: application/json

{
  "name"            : "My First Asset",
  "model"           : "https://models.authentise.com/model/aed631aa-f7b2-46dc-964d-ecbe3bca4c19/",
  "versions"        : ["https://models.authentise.com/asset-version/28b6bc3c-b898-49bb-939e-33f0e72a5404/"]
}

Now that we can see all of the asset versions tied to this model lets look up a specific one and see what that change was

GET https://models.authentise.com/asset-version/uuid/
Content-Type: application/json

{
  "name"               : "My First Asset Version",
  "message"            : "This is my first change to my model",
  "original_model"     : "https://models.authentise.com/model/aed631aa-f7b2-46dc-964d-ecbe3bca4c19/",
  "new_model"          : "https://models.authentise.com/model/7d6079e2-f071-4057-9fe1-35e10980835c/",
}

So in here we can see the original model, the new model and the nice message we left informing us that this was our first adjustment. Now all of you can add some awesome managing of your models.