Skip to content
Java Client of Toggl's Reports API
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src improved api Mar 9, 2017
.gitignore
README.md
pom.xml

README.md

Java Client of Toggl's Reports API

This project is a Java client for the public Toggl' Reports API. The client is based on a fluent java api that maps the cascade of methods to the Toggl's api endpoints. For example:

Compilation

mvn compile

Dependency

Thank's to jitpack it's very easy to use current builds

Step 1. Add the JitPack repository to your build file

<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>

Step 2. Add the dependency

<dependency>
    <groupId>com.github.rocketbase-io</groupId>
    <artifactId>toggl-report-api</artifactId>
    <version>toggl-report-api-1.0.0</version>
</dependency>

Usage

Very short examples you can also find within the tests goto tests

simply get it running

public static void main(String[] args) {
    TogglReportApi togglReportApi = new TogglReportApiBuilder()
                    .apiToken(API_TOKEN)
                    .userAgent(USER_AGENT)
                    .workspaceId(WORKSPACE_ID)
                    .build();
    
    WeeklyUsersTimeResult result = togglReportApi.weeklyUsersTime()
                    .since(start)
                    .get();
    
    System.out.println(result);
}

FetchAllDetailed

Fetch full list of all Detailed Results. The FetchAllDetailed cares about paging

List<TimeEntry> resultList = FetchAllDetailed.getAll(togglReportApi.detailed()
        .until(start)
        .since(end)
        .billable(Billable.BOTH));

Spring Context

To use this client in a Spring application consider the following setup:

@Configuration
public class TogglReportApiConfiguration {

    @Bean
    public TogglReportApi togglReportApi(@Value("${toggl-api.token}") String token, 
                    @Value("${toggl-api.user-agent}") String userAgent,
                    @Value("${toggl-api.workspace-id}") Long workspaceId) {
        return new TogglReportApiBuilder()
                       .setApiToken(token)
                       .setUserAgent(userAgent)
                       .setWorkspaceId(workspaceId)
                       .build();
    }
    
}

Dependencies

This API depends on three other popular modules:

  • org.springframework artifact spring-web version 4.3.5.RELEASE

  • com.google.guava artifact guava version 21.0

  • com.fasterxml.jackson.core artifact jackson-databind version 2.8.6

  • org.apache.httpcomponents artifact httpclient version 4.6

Since all these artifacts are pretty popular take with care the possible artifact's version conflicts. If you are going to use this software under an Android device consider the httpclient issues.

You can’t perform that action at this time.