Burning Man Gallery Upload API

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

http://galleries.burningman.org/plugins/api_upload

Request Parameters

Param Type Description Required
keystringauth keyY
userfile@filefile handle for uploadY
fileurlstringurl of file to upload (can be used instead of userfile)N
resourcetypeintegerresource typeN
archiveintegerarchive status (default 0 active)N
collectionlistboolreturn writable collections for this user in JSON format (default 'false')N
collectionlist_searchstringfilter the collection list with a search stringN
collectionintegercollection to upload toY
prettyfieldnamesboolfeedback shows field names instead of 'field#' (default false)N
contributedbyboolfeedback shows 'contributed by' (default true)N
field8stringTitleY
field25stringCaptionY
field76stringCategory (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
field79stringYearY
field10stringPhoto CreditsN

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