MediaMiser RESTful API Pull Client

MediaMiser's pull client

MediaMiser's pull client is a client library and demonstration of how to connect to and consumer from MediaMiser's one-legged OAuth1.0a authenticated RESTful spouts resources (i.e. pull connector streams) which deliver social media network metadata.

This library uses a Jersey 2.x-based Java client to access spouts. See the library's API documentation for examples on how to use each utility.

Usage

You can include this project in your own by adding the following dependency to your project's pom.xml file:

<dependency>
  <groupId>com.mediamiser</groupId>
  <artifactId>pull-client</artifactId>
  <version>0.0.0</version>
</dependency>

To test consuming from MediaMiser's APIs:

1. Edit src/test/resources/configuration.properties to contain your credentials and the MediaMiser API endpoint:

    consumer.key		= <your consumer key>
    consumer.secret		= <your consumer secret>
    access.token.key	= <your access token key>
    access.token.secret	= <your access token secret>
   

2. Modify or run src/test/java/com/mediamiser/example/Main.java to setup callbacks to handle data as it comes in and start/stop pulling data.

Development

To build this project, your development environment must have installed:

• Oracle JDK 7
• Apache Maven 3.x

To test locally, check out the repository and use Maven to compile and run the tests:

user@localhost$ git clone https://github.com/MediaMiser/pull-client.git
user@localhost$ cd pull-client
user@localhost$ mvn clean test

Licensing

The MediaMiser Pull Client is licensed under the BSD 3-Clause license.

Authors and Contributors

This project was authored by @samer-albuhaisi and @cfournie at MediaMiser.