Sharing models

All models on 3DIAX can be shared. Users can be given specific or all rights on a model.

Here is a list of all possible rights:

  • all: This right gives full access to the model.
  • print: This right gives print right which permits printing a model.
  • transform: This right permits running internal transforms of a model.
  • transform-external: This right allows external transforms of a model.
  • view: This right lets a model to be seen.
  • download: This right lets a model to be downloaded.

Create a new share

Now that we know the list of rights we can give on a model, let’s share a model with user named John.

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

{
  "model": "https://models.authentise.com/model/abc-xyz/',
  "user": "https://users.authentise.com/user/abc-xyz/",
  "type": "all"
}
Location: https://users.authentise.com/permission/abc-xyz/

After the above call is executed, user https://users.authentise.com/user/abc-xyz/ will be granted right all on model https://models.authentise.com/model/abc-xyz/

List our own shares

This request will return all of our shares.

GET https://models.authentise.com/share/
Content-Type: application/json
{
  "resources": [{
    "model": "https://models.authentise.com/model/abc-xyz/",
    "user": "https://users.authentise.com/user/abc-xyz/",
    "type": "all",
    "grantor": "https://users.authentise.com/user/abc-xyz/"
  }]
}

In this example, we only have one share that gave us full access to model abc-xyz.

Delete a share

In the first example, we granted all right on our model to John. Here is how to revoke this right and to hide the model from them.

DELETE https://models.authentise.com/share/abc-xyz/

This will delete the share abc-xyz that gave all right to John.