Skip to main content

A Thin JamBase API Client library for Django/Python Applications.

Project description

A Python Jambase API Client Library

Getting Started

$ pip install DjamBase

Get a valid Developer API key at http://developer.jambase.com.

import DjamBase

 db = DjamBase.API("your_api_key")

Usage

db.artist_search(params)

-‘params’ is a dictionary, with: {"id": <int>, "name": <str>} as valid key, value options. These will serve as the JamBase Artist search parameters.

db.venue_search(params)

-‘params’ is a dictionary, with: {"id": <int>, "zipCode": <int>, "radius"*: <int>} as valid key, value options. These are the JamBase Venue search parameters.

db.event_list(params)

-‘params’ is a dictionary, with:

{
"id": <int>,
"artist": <str>,
"artistId": <int>,
"band": <str>,
"bandId": <int>,
"venueId": <int>,
"zipCode": <int>,
"radius": <int>,
"startDate": <YYYY-MM-DD>,
"endDate": <YYYY-MM-DD> } as possible valid key, value options. These are the JamBase Event search parameters.

Use any combination of a functions’ available parameters that you like, depending on the desired results. Notice that all keys are written in “camelCase”.

Use as below:

r = db.event_list( {"name": "the foobar fighters", "radius": 200} )

Response

Of course, you can use whatever variable name you like, but the above variable “r” will contain a response object. It’s that simple! The “.body” attribute of this object contains the response in JSON format. If you would like XML, pass “xml” as the optional 2nd argument when instantiating the client.

r.body

-Use this response object property retrieve the content of the search response. JSON by default.

r.status

-This property will give you access to the dialogues’ HTTP status code, in case there are issues.

r.text

-This property will give you a stringified version of the JSON response.

r.binary

-This property will get you binary version of the response.

json = r.body
 print json

Example

   import DjamBase

    db = DjamBase.API("your_api_key", "xml")

    r = db.event_list( {"name": "the foobar fighters", "radius": 200} )
    code = r.status
    print code      **<Response-200>**

    xml = r.body
    print xml


*** miles

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

DjamBase-1.0.5.tar.gz (39.8 kB view hashes)

Uploaded Source

Built Distribution

DjamBase-1.0.5.macosx-10.11-intel.exe (111.0 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page