Difference between revisions of "CDN API Documentation"
Jump to navigation
Jump to search
Line 21: | Line 21: | ||
==Retrieving Single Model Info== | ==Retrieving Single Model Info== | ||
− | + | /api/modelinfo/BASENAME/VERSION | |
This retrieves the JSON for a single model with all of its formats. | This retrieves the JSON for a single model with all of its formats. | ||
Line 29: | Line 29: | ||
==Browsing the CDN== | ==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. | 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. | ||
Line 38: | Line 38: | ||
==Uploading== | ==Uploading== | ||
− | + | /api/upload | |
==Upload Status== | ==Upload Status== | ||
− | + | /upload/processing |
Revision as of 21:39, 31 January 2012
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
http://open3dhub.com/api/browse/ http://open3dhub.com/api/browse/?start=1313667443311513
Uploading
/api/upload
Upload Status
/upload/processing