filmaster-api-sample / README

this directory contains few Filmaster API samples:

* common_recs - simple pure js sample - anonmouse requests with jsonp output format, to run simply point your browser to common_recs/index.html
* - simple Facebook application, using our OAuth extension for authenticating Facebook users (for Google AppEngine platform)
* - simple webapp using standard OAuth authorization (GAE), for easy API exploring
* - command line API client, for testing OAuth authentication are are designed to run on Google AppEngine platform - visit to learn how to run they locally or deploy to GAE servers. 

Quick start guide:
* generate your key / secret at:
* create using, providing required Filmaster and Facebook app credentials
* run google_appengine/ filmaster-api-sample
* point your browser to http://localhost:8080/api-explorer/ or http://localhost/fbapp/

These examples are deployed already here:
* usage:

$ python --help

Usage: [options] key secret

  -h, --help            show this help message and exit
  -t ACCESS_TOKEN, --access-token=ACCESS_TOKEN
                        OAuth access token
  -c CALLBACK_URL, --callback-url=CALLBACK_URL
                        OAuth callback url
  -f FB_ACCESS_TOKEN, --fb-access-token=FB_ACCESS_TOKEN
                        Facebook access token, for login/auto-create users
                        associated with fb account
  -v, --verbose         Verbose

to test standard OAuth run:
$ python filmaster_app_key filmaster_app_secret -c http://fake_callback/

to test our OAuth extension for authenticating Facebook users run:
$ python filmaster_app_key filmaster_app_secret -f facebook_access_token

If you have filmaster oauth access_token already (it is displayed by above commands) you may authenticate usint it - run:
$ python filmaster_app_key filmaster_app_secret -t filmaster_access_token

All python examples use filmaster_auth.FilmasterOAuthClient class implementing simple API client, ( file contains short documentation)