/api/model

Download and upload 3D models




Get
/api/model
Get list of models.

Returns JSON format list of models created by the API account making the request



Get
/api/model?id={id}
Get JSON info for model with given id.

This is more detailed info that returned in a list of models, and includes resource files information for the model
(such as dependent texture files, material files etc)



Get
/api/model?cmd=user&p={userid}
Get list of models for user with given id

Returns JSON format list of models created by specified user
(Requires Admin rights)



Get
/api/model?cmd=tag&p={TAGS}
Get list of models that include the given tag(s)

if more than one tag, tags should be separated by a _



Get
/api/models?cmd=modified&p={timestamp}
Get list of models modified (or created) since given timestamp




Get
/api/models?cmd=created&p={timestamp}
Get list of models created since given timestamp




Get
/api/models?id={id}
Download model with given id in default OBJ format

The OBJ format model is returned as txt.



Get
/api/models?id={id}&fmt={format_specifier}
Download model with given id in specified format.

Format specifier must be one of obj, ply, stl,stla,stlb, fbx, js, points_a, points_b
Text formats are returned as txt.
Binary formats are returned as bin.



Post
/api/model?id=-1&p={filename}
Upload new model file

This is the main model file and should be OBJ, PLY, STL
The body of the post should contain the model in application/octet-stream format
Returns id of the model created



Post
/api/model?id={id}&p={filename}
Upload model resource file or replace model file

This uploads a file for an existing model. the model id must be valid
if the filename matches the model filename, the main model file is replaced
Otherwise a resource file of the given filename is created and its contents set from body
Resources must have one of the following extensions
MTL, PNG, JPG, JPEG



Post
/api/model?id={id}&key={KEY}&p={TAGS}
Upload value for a specified key associated with a model

Valid keys are
TITLE
DESCRIPTION
AUTHOR
TAGS



Post
/api/model?id={id}&key=JSON
Upload value for specified keys for model, which are in JSON format in post body


!Example JSON:
{
   title :

"my model"

,
   description :

"by me"

,
   author :

"me"

,
   tags : [

"building"

,

"modern"

,

"skyscraper"

]
}