42 lines
1.7 KiB
Markdown
42 lines
1.7 KiB
Markdown
# go-osuapi [](https://godoc.org/github.com/thehowl/go-osuapi) [](https://travis-ci.org/thehowl/go-osuapi) [](https://goreportcard.com/report/github.com/thehowl/go-osuapi)
|
|
|
|
go-osuapi is an osu! API library for Golang.
|
|
|
|
## Getting started
|
|
|
|
Everything is (more or less) well-documented at [godoc](https://godoc.org/github.com/thehowl/go-osuapi) - the methods that interest you most are probably those under [Client](https://godoc.org/github.com/thehowl/go-osuapi#Client). Also, [client_test.go](client_test.go) contains loads of examples on how you can use the package. If you still want to have an example to simply copypaste and then get straight to coding, well, there you go!
|
|
|
|
```go
|
|
package main
|
|
|
|
import (
|
|
"fmt"
|
|
"gopkg.in/thehowl/go-osuapi.v1"
|
|
)
|
|
|
|
func main() {
|
|
c := osuapi.NewClient("Your API key https://osu.ppy.sh/p/api")
|
|
beatmaps, err := c.GetBeatmaps(osuapi.GetBeatmapsOpts{
|
|
BeatmapSetID: 332532,
|
|
})
|
|
if err != nil {
|
|
fmt.Printf("An error occurred: %v\n", err)
|
|
return
|
|
}
|
|
for _, beatmap := range beatmaps {
|
|
fmt.Printf("%s - %s [%s] https://osu.ppy.sh/b/%d\n", beatmap.Artist, beatmap.Title, beatmap.DiffName, beatmap.BeatmapID)
|
|
}
|
|
}
|
|
```
|
|
|
|
## I want more than that to explore how it works!
|
|
|
|
I've made [whosu](https://github.com/thehowl/whosu) for that purpose. Check it out.
|
|
|
|
## Contributing
|
|
|
|
Contributions are welcome! Here's what you need to know:
|
|
|
|
* Always `go fmt` your code.
|
|
* If you're writing a big and useful feature, make sure to appropriately write tests!
|