Skip to content

Latest commit

 

History

History
101 lines (77 loc) · 2.67 KB

README.md

File metadata and controls

101 lines (77 loc) · 2.67 KB
Raw

trakt-java

A Java wrapper around the trakt API using retrofit.

Remote services are grouped into local service objects which can be centrally managed by a Trakt instance. It will act as a factory for all of the services and will automatically initialize them with your credentials and API key.

Usage

Add the following dependency to your Gradle project:

compile 'com.uwetrottmann:trakt-java:3.2.0'

Or for Maven:

<dependency>
  <groupId>com.uwetrottmann</groupId>
  <artifactId>trakt-java</artifactId>
  <version>3.2.0</version>
</dependency>

Dependencies

If you rather use the released jar, add dependencies yourself as you see fit. For example for Gradle:

compile 'com.squareup.retrofit:retrofit:1.5.0'

Or for Maven:

<dependency>
  <groupId>com.squareup.retrofit</groupId>
  <artifactId>retrofit</artifactId>
  <version>1.5.0</version>
</dependency>

You also might want to use the OkHttp client, but it is not required.

Calling endpoints

Trakt trakt = new Trakt();
trakt.setAuthentication("username", "sha1_of_password");
trakt.setApiKey("api_key");

// Create service instance
ShowService showService = trakt.showService();

// Get trending shows on trakt
List<TvShow> shows = showService.trending();
for (TvShow show : shows) {
	System.out.println("Title: " + show.title);
}

// Post an episode as seen
Response response = showService.episodeSeen(new ShowService.Episodes(
    153021 // TVDb id of show, 1 // season, 1 // episode
));
if (response != null && response.status == Status.SUCCESS) {
    System.out.println("Successfully checked into show.");
}

See test cases in src/test/ for more examples.

Original Implementation

License

Copyright 2013-2014 Uwe Trottmann

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.