Overview
For uploading resources to the Burning Man Galleries
API Key and Credentials
In order to use the Burning Man Gallery API you must have an API key attached to a user with the correct credentials. Once you have created a user on the galleries site (http://galleries.burningman.org), email innovate@burningman.org with your username to request access to the API. You can then go here: http://galleries.burningman.org/plugins/api_core/index.php to obtain your API key.
URL
Request Parameters
Param | Type | Description | Required |
---|---|---|---|
key | string | auth key | Y |
userfile | @file | file handle for upload | Y |
fileurl | string | url of file to upload (can be used instead of userfile) | N |
resourcetype | integer | resource type | N |
archive | integer | archive status (default 0 active) | N |
collectionlist | bool | return writable collections for this user in JSON format (default 'false') | N |
collectionlist_search | string | filter the collection list with a search string | N |
collection | integer | collection to upload to | Y |
prettyfieldnames | bool | feedback shows field names instead of 'field#' (default false) | N |
contributedby | bool | feedback shows 'contributed by' (default true) | N |
field8 | string | Title | Y |
field25 | string | Caption | Y |
field76 | string | Category (one of the following): Art BRAF Burning Man Project Desert / Nature Illustrations Mobile Art Night of the Burn Other / Misc People Performances The Man Theme Camps Year Round Events | Y |
field79 | string | Year | Y |
field10 | string | Photo Credits | N |
Example Response
{ "resource": [ { "score": "0", "ref": "62810", "resource_type": "1", "has_image": "1", "is_transcoding": "0", "hit_count": "0", "creation_date": "2015-06-08 14:54:26", "rating": "", "user_rating": "", "user_rating_count": "", "user_rating_total": "", "file_extension": "jpg", "preview_extension": "jpg", "image_red": "1000", "image_green": "526", "image_blue": "0", "thumb_width": "150", "thumb_height": "100", "archive": "0", "access": "1", "colour_key": "EKOWY", "created_by": "5123", "file_modified": "2015-06-08 14:54:29", "file_checksum": "936db77e653fed40542da8d7a72f2e94", "request_count": "0", "new_hit_count": "0", "expiry_notification_sent": "0", "preview_tweaks": "0|1", "file_path": "", "group_access": "", "user_access": "", "field79": "2015", "field8": "Title Test", "field82": "", "field76": ",Art", "field87": "", "field86": "", "field88": "", "field89": "", "field109": "", "field91": "", "field105": "", "field71": "640x427", "field25": "Caption Test", "field12": "", "Width": "640", "Height": "427", "Contributed_by": "testuser" } ] }