com.uwetrottmann.tmdb2.services.AuthenticationService Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of tmdb-java Show documentation

tmdb-java is a retrofit2 based wrapper around the themoviedb.org API v3.

The newest version!

package com.uwetrottmann.tmdb2.services;

import com.uwetrottmann.tmdb2.Tmdb;
import com.uwetrottmann.tmdb2.entities.GuestSession;
import com.uwetrottmann.tmdb2.entities.RequestToken;
import com.uwetrottmann.tmdb2.entities.Session;
import retrofit2.Call;
import retrofit2.http.GET;
import retrofit2.http.Query;

public interface AuthenticationService {

    /**
     * Requests authentication Token.
     */
    @GET(Tmdb.PATH_AUTHENTICATION + "/token/new")
    Call requestToken();

    /**
     * Attempts to Login with a Request Token and Username/Password.
     *
     * @param username      Username of TMDb Account.
     * @param password      Password of TMDb Account.
     * @param request_token The Token you requested.
     */
    @GET(Tmdb.PATH_AUTHENTICATION + "/token/validate_with_login")
    Call validateToken(
            @Query("username") String username,
            @Query("password") String password,
            @Query("request_token") String request_token
    );

    /**
     * Creates TvSeason with the Request Token you validated with your username/password.
     *
     * @param request_token The Token you requested.
     */
    @GET(Tmdb.PATH_AUTHENTICATION + "/session/new")
    Call createSession(
            @Query("request_token") String request_token
    );

    /**
     * Creates Guest TvSeason
     */
    @GET(Tmdb.PATH_AUTHENTICATION + "/guest_session/new")
    Call createGuestSession();
}