Getting File Group Info
Upload API allows creating file groups and requesting the respective info.
GET /group/info/
Such requests return a JSON dictionary holding your group info.
Query parameters
pub_key, string
Defines a target project you work with, by its public key.
If pub_key
is missing, method returns an error,
[HTTP 400] pub_key is required.
group_id, string
Group IDs look like UUID~N
, where N stands for a number of files in a group.
If the parameter is missing, method returns an error,
[HTTP 400] group_id is required.
If a group identified by group_id
does not exist, you get an error,
[HTTP 404] group_id is invalid.
Requesting group info, example
Request:
curl "https://upload.uploadcare.com/group/info/?pub_key=demopublickey\
&group_id=d52d7136-a2e5-4338-9f45-affbf83b857d~2"
Response:
{
"id": "d52d7136-a2e5-4338-9f45-affbf83b857d~2",
"datetime_created": "2015-09-21T12:39:13.743754Z",
"datetime_stored": null,
"files_count": 2,
"cdn_url": "http://www.ucarecdn.com/d52d7136-a2e5-4338-9f45-affbf83b857d~2/",
"url": "https://api.uploadcare.com/groups/d52d7136-a2e5-4338-9f45-affbf83b857d~2/",
"files": [
{
"default_effects": "",
"is_stored": true,
"done": 122448,
"file_id": "6e013b2b-a88b-45ff-9dba-9cc60c6531cc",
"total": 122448,
"size": 122448,
"uuid": "6e013b2b-a88b-45ff-9dba-9cc60c6531cc",
"is_image": true,
"filename": "ScreenShot20110927at30439.jpeg",
"is_ready": true,
"original_filename": "Screen Shot 2011-09-27 at 3.04.39.jpeg",
"image_info": {
"orientation": 1,
"format": "JPEG",
"height": 826,
"width": 718,
"geo_location": null,
"datetime_original": null
}
},
{
"default_effects": "",
"is_stored": true,
"done": 192519,
"file_id": "0c081c58-6788-4b90-bb0e-6f0af0802294",
"total": 192519,
"size": 192519,
"uuid": "0c081c58-6788-4b90-bb0e-6f0af0802294",
"is_image": true,
"filename": "201311152128.jpeg",
"is_ready": true,
"original_filename": "Screen Shot 2013-12-13 at 1.07.21.jpeg",
"image_info": {
"orientation": 1,
"format": "JPEG",
"height": 898,
"width": 834,
"geo_location": null,
"datetime_original": null
}
}
]
}