47 lines
1.3 KiB
Markdown
47 lines
1.3 KiB
Markdown
|
# Football-Data API for Golang
|
||
|
|
||
|
[](https://travis-ci.org/icedream/go-footballdata)
|
||
|
[](https://godoc.org/github.com/icedream/go-footballdata)
|
||
|
|
||
|
This library provides functionality to communicate with the API provided by http://football-api.org. This way programs can use data provided by the API in order to show information about football/soccer games from various seasons for free.
|
||
|
|
||
|
## How to use this library?
|
||
|
|
||
|
Before you use this library please [register for a free API key](http://api.football-data.org/register) in order to increase your usage limits. The library also works without an API key.
|
||
|
|
||
|
You can install this library by running:
|
||
|
|
||
|
go get github.com/icedream/go-footballdata
|
||
|
|
||
|
Afterwards you can use this library like this:
|
||
|
|
||
|
```go
|
||
|
package main
|
||
|
|
||
|
import (
|
||
|
"fmt"
|
||
|
"net/http"
|
||
|
|
||
|
"github.com/icedream/go-footballdata"
|
||
|
)
|
||
|
|
||
|
func main() {
|
||
|
// Create client
|
||
|
client := footballdata.NewClient(http.DefaultClient)
|
||
|
|
||
|
// Tell it to use our API token
|
||
|
client.AuthToken = "<insert your api token here>"
|
||
|
|
||
|
// Get list of seasons...
|
||
|
seasons, err := client.SoccerSeasons().Do()
|
||
|
if err != nil {
|
||
|
panic(err)
|
||
|
}
|
||
|
|
||
|
// ...and print them
|
||
|
for _, season := range seasons {
|
||
|
fmt.Println(season.Id, season.Caption)
|
||
|
}
|
||
|
}
|
||
|
|
||
|
```
|