Combining asset database and scalable object storage
Media assets are stored in the Filerobot File System in the Cloud, a distributed file system combining multi-provider and multi-location object storage and a distributed asset database to keep file information like metadata, asset information and various other parameters needed to build a scalable and flexible file system in the Cloud.
A file stored in the Filerobot File System can be accessed via:
store.filerobot.com/{token}/{folder}/{filename}
This URL points to the origin asset in the Filerobot storage. It is not meant to be used on your web or mobile application as it is neither optimized nor delivered over CDN. You should rather use the Filerobot CDN URL, which will deliver optimized and accelerated assets.
You can obtain your {token} by subscribing to a Filerobot account.
Data model
Each file is described in the Filerobot file system using following JSON structure:
{
"status": "success",
"file": {
"uuid": "1f78b9d1-98fe-53db-82a4-8c9aafb50000",
"name": "product_0f0.jpg",
"extension": "jpg",
"size": {
"bytes": 4905337,
"pretty": "4.68 MB"
},
"flags": [],
"type": "image/jpeg",
"info": {
"img_h": 3744,
"img_w": 5616,
"img_type": "JPEG",
"visibility": "2"
},
"meta": {
"sku": "SC04-GRLX6",
"color": [
"@itm_v1_70e8447c_4@"
],
"price": "110",
"title": {
"de_DE": "Luxusschal",
"en_US": "Luxury Scarf",
"fr_FR": "\u00c9charpe de luxe",
"it_IT": "Sciarpa di lusso"
},
"category": [
"@itm_v1_b2439f66_c@"
],
"material": "40% silk, 40% Merino wool, 20% cotton",
"description": {
"de_DE": "Luxusschal",
"en_US": "Luxury Scarf",
"fr_FR": "\u00c9charpe de luxe",
"it_IT": "Sciarpa di lusso"
},
"available_from1": "2021-05-06"
},
"tags": {},
"visibility": {
"value": "VISIBILITY_INHERIT",
"inherited": "VISIBILITY_PUBLIC",
"set": "VISIBILITY_INHERIT",
"actual": "VISIBILITY_PUBLIC"
},
"url": {
"public": "https://store.filerobot.com/fdocs/api-demo/product_0f0.jpg",
"permalink": "https://api.filerobot.com/fdocs/v4/get/1f78b9d1-98fe-53db-82a4-8c9aafb50000",
"cdn": "https://fdocs.filerobot.com/api-demo/product_0f0.jpg?vh=0982ad",
"path": "/api-demo/product_0f0.jpg"
},
"hash": {
"sha1": "0982ad36c60b87d10105519fce96965a754b67a8",
"blurhash": "LAGl9k0J0jys?_yE.9Vs4T-oH=I:"
},
"created_at": "2021-05-05T15:41:44Z",
"modified_at": "2021-05-05T16:44:09Z",
"folder": {
"uuid": "7610923e-80d0-50e8-a2e4-c509be390158",
"name": "/api-demo"
},
"product": {
"ref": null,
"position": null
}
}
}Most attributes are self explanatory but below is a detailed description of the main attributes you will work with:
| Attribute name | Description |
|---|---|
| uuid | Unique identified of the file |
| size | The size in bytes of the file |
| info | Properties of the file. For images, we automatically add the size (width and height) as well as the image format (img_type) |
| meta | Metadata. Used to store the file's tags, and any custom metadata fields you want to add for later use |
| description | Description of the file |
| url.public | Public URL to access the file, identified by its filename |
| url.permalink | Public URL to access the file, identified by its uuid |
| url.cdn | Public URL to deliver the file via CDN. This allows media transformations and filters. |
Info and Metadata are key:value fields of the file description and are used for search. Metadata can be customized.
...
...
With the metadata permission model, your team can collaborate by granting per-field and per-language view and edit permission on a company or user level.
Each metadata field value can be or not be delivered in the asset header in public listings and downloads.
Details on metada, tags and localization can be found under Taxonomy.