What is implemented?

Authentication
User data, including courses information and progress
Subscriptions (friends)
Leaderboards
XP Summaries

Prepare

Most of methods require authentication. One way is to provide token, which you get after login and set your enviromental variables:

export DUO_TOKEN=<your_token_here>
export DUO_USERNAME=<your_username_here>

Read them in Go:

token := os.Getenv("DUO_TOKEN")
username := os.Getenv("DUO_USERNAME")

Advantage of this approach that you do not need to store your password anywhere. Also, token is stored only for the duration of the terminal session.

Usage

Basic example example2/main.go shows how to retrieve the user information and output userID by given username.

package main

import (
	"fmt"
	"os"
	"time"

	httptransport "github.com/go-openapi/runtime/client"
	"github.com/go-openapi/strfmt"
	"github.com/igorskh/go-duolingo/client"
	"github.com/igorskh/go-duolingo/client/users"
	"github.com/igorskh/go-duolingo/duo"
)

func main() {
	token := os.Getenv("DUO_TOKEN")
	username := os.Getenv("DUO_USERNAME")
	baseURL := "www.duolingo.com"

	pageParseRes, err := duo.ParseMainPage("https://" + baseURL)
	if err != nil {
		panic(err)
	}

	cl := client.New(httptransport.New(baseURL, pageParseRes.BasePath, nil), strfmt.Default)
	auth := httptransport.BearerToken(token)

	params := users.NewGetUsersParamsWithTimeout(5 * time.Second)
	params.SetUsername(username)

	resp, err := cl.Users.GetUsers(params, auth)
	if err != nil {
		panic(err)
	}
	fmt.Println(resp.Payload.Users[0].ID)
}

High-level API Access

Package github.com/igorskh/go-duolingo/duo is an additional layer of abstraction which simplifies access to the API functions.

Example in examples/main.go shows the process of retrieving userID, but using high-level client.

package main

import (
	"fmt"
	"os"

	httptransport "github.com/go-openapi/runtime/client"
	"github.com/go-openapi/strfmt"
	"github.com/igorskh/go-duolingo/client"
	"github.com/igorskh/go-duolingo/duo"
)

func main() {
	token := os.Getenv("DUO_TOKEN")
	username := os.Getenv("DUO_USERNAME")
	baseURL := "www.duolingo.com"
	lbBaseURL := "duolingo-leaderboards-prod.duolingo.com"

	pageParseRes, err := duo.ParseMainPage("https://" + baseURL)
	if err != nil {
		panic(err)
	}
	duoClient := duo.Client{
		Auth:     httptransport.BearerToken(token),
		Client:   client.New(httptransport.New(baseURL, pageParseRes.BasePath, nil), strfmt.Default),
		ClientLB: client.New(httptransport.New(lbBaseURL, "", nil), strfmt.Default),
	}

	myUser, err := duoClient.GetUser(username)
	if err != nil {
		panic(err)
	}
	fmt.Println(myUser.ID)
}

Serialising to JSON

bytes, err := json.Marshal(obj)
if err != nil {
    fmt.Println("Error while serialising", obj)
}

Variable bytes contains bytes array of JSON string and can be easily converted to string as string(bytes).

fmt.Println(string(bytes))