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"
}
]
}