uploadcaredocs

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": "Снимок экрана 2013-11-15 в 21.28.jpeg",
      "image_info": {
        "orientation": 1,
        "format": "JPEG",
        "height": 898,
        "width": 834,
        "geo_location": null,
        "datetime_original": null
      }
    }
  ]
}

We’re always happy to help with code, integration, and other stuff. Search our site for more info or post your question in our Community Area.