3DI API

3D REST API documentation

Auth

Every API call must provide two params - key and token, which can be obtained by registered users at
http://3dpartsource.com/account/api
If key or token are incorrect, API will return 401 Not Authorized HTTP code with empty body.

Model Resource

GET /api/v1/model

Returns a list of all active models. 10 items per page.

Supported optional params:

page - for pagination purposes.
perPage - for pagination purposes (max 100).
text - text to search by.
file and fileName - link to model file and file name to search models by. If search by file is used, both of these params are required.
file_type - model file type (e.g. "obj").
price_type - possible values: "free", "premium".


POST /api/v1/model/search

Returns a list of all active models by example model. 10 items per page.

Required params:

file - File (Content-Disposition: form-data; name=“file”; filename=“filament_guide.stl” Content-Type: application/octet-stream)

Supported optional params:

page - for pagination purposes.
perPage - for pagination purposes (max 100).
text - text to search by.
file_type - model file type (e.g. "obj").
price_type - possible values: "free", "premium".

Examples

http://3dpartsource.com/api/v1/model?key=<key>&token=<token> - get first 10 active models http://3dpartsource.com/api/v1/model?key=<key>&token=<token>&page=2 - get second 10 active models

http://3dpartsource.com/api/v1/model?key=<key>&token=<token>&text=phone%20case - search models by text 'phone case', returns list of first 10 found models http://3dpartsource.com/api/v1/model?key=<key>&token=<token>&text=phone%20case&page=2 - search models by text 'phone case', returns list of second 10 found models

http://3dpartsource.com/api/v1/model?key=<key>&token=<token>&fileName=filament_guide.stl&file=http://www.thingiverse.com/download:606330 - search models by external model file

http://3dpartsource.com/api/v1/model?key=<key>&token=<token>&fileName=filament_guide.stl&file=http://www.thingiverse.com/download:606330&text=phone%20case - search models by external model file AND by text.

Feedback