CDN API Documentation
Model URLs
The URL for a model consists of:
meerkat://[HOSTNAME]/BASENAME/FORMAT[/VERSION]
Where:
- BASENAME = The user-chosen path for the model, e.g. /jterrace/duck.dae
- HOSTNAME = Address of the CDN server. If not specified, the OH client defaults to open3dhub.com
- FORMAT = One of the CDN formats. Currently supported are "priginal", "pptimized" and "progressive".
- VERSION = The version number of the model. If not specified, the latest version is returned by the CDN.
Examples
- Returns the latest version of optimized format:
meerkat:///jterrace/models/plantbox.dae/optimized/plantbox.dae
- Returns progressive format, version 0:
meerkat:///jterrace/models/plantbox.dae/progressive/0/plantbox.dae
- Loads from a server on localhost:
meerkat://localhost:8080/jterrace/box.dae
Note
The filename at the end of the URL is technically optional, but the OH won't pick up dependent files, like textures, without it.
Retrieving Single Model Info
/api/modelinfo/BASENAME/VERSION
This retrieves the JSON for a single model with all of its formats.
Example
http://open3dhub.com/api/modelinfo/jterrace/models/plantbox.dae/0
Browsing the CDN
/api/browse/[?start=TIMESTAMP]
This browses the models on the CDN. Without a start argument, returns the most recent 25 models on the CDN. It will also contain a "next_start" value, which you can pass later to start at the next timestamp to continue browsing.
Examples
Uploading
/api/upload
Upload Status
/upload/processing