143 lines
3.7 KiB
Markdown
143 lines
3.7 KiB
Markdown
# go-mastodon
|
|
|
|
[![Build Status](https://travis-ci.org/mattn/go-mastodon.svg?branch=master)](https://travis-ci.org/mattn/go-mastodon)
|
|
[![Coverage Status](https://coveralls.io/repos/github/mattn/go-mastodon/badge.svg?branch=master)](https://coveralls.io/github/mattn/go-mastodon?branch=master)
|
|
[![GoDoc](https://godoc.org/github.com/mattn/go-mastodon?status.svg)](http://godoc.org/github.com/mattn/go-mastodon)
|
|
[![Go Report Card](https://goreportcard.com/badge/github.com/mattn/go-mastodon)](https://goreportcard.com/report/github.com/mattn/go-mastodon)
|
|
|
|
## Usage
|
|
|
|
### Application
|
|
|
|
```go
|
|
package main
|
|
|
|
import (
|
|
"context"
|
|
"fmt"
|
|
"log"
|
|
|
|
"github.com/mattn/go-mastodon"
|
|
)
|
|
|
|
func main() {
|
|
app, err := mastodon.RegisterApp(context.Background(), &mastodon.AppConfig{
|
|
Server: "https://mstdn.jp",
|
|
ClientName: "client-name",
|
|
Scopes: "read write follow",
|
|
Website: "https://github.com/mattn/go-mastodon",
|
|
})
|
|
if err != nil {
|
|
log.Fatal(err)
|
|
}
|
|
fmt.Printf("client-id : %s\n", app.ClientID)
|
|
fmt.Printf("client-secret: %s\n", app.ClientSecret)
|
|
}
|
|
```
|
|
|
|
### Client
|
|
|
|
```go
|
|
package main
|
|
|
|
import (
|
|
"context"
|
|
"fmt"
|
|
"log"
|
|
|
|
"github.com/mattn/go-mastodon"
|
|
)
|
|
|
|
func main() {
|
|
c := mastodon.NewClient(&mastodon.Config{
|
|
Server: "https://mstdn.jp",
|
|
ClientID: "client-id",
|
|
ClientSecret: "client-secret",
|
|
})
|
|
err := c.Authenticate(context.Background(), "your-email", "your-password")
|
|
if err != nil {
|
|
log.Fatal(err)
|
|
}
|
|
timeline, err := c.GetTimelineHome(context.Background(), nil)
|
|
if err != nil {
|
|
log.Fatal(err)
|
|
}
|
|
for i := len(timeline) - 1; i >= 0; i-- {
|
|
fmt.Println(timeline[i])
|
|
}
|
|
}
|
|
```
|
|
|
|
## Status of implementations
|
|
|
|
* [x] GET /api/v1/accounts/:id
|
|
* [x] GET /api/v1/accounts/verify_credentials
|
|
* [x] PATCH /api/v1/accounts/update_credentials
|
|
* [x] GET /api/v1/accounts/:id/followers
|
|
* [x] GET /api/v1/accounts/:id/following
|
|
* [x] GET /api/v1/accounts/:id/statuses
|
|
* [x] POST /api/v1/accounts/:id/follow
|
|
* [x] POST /api/v1/accounts/:id/unfollow
|
|
* [x] GET /api/v1/accounts/:id/block
|
|
* [x] GET /api/v1/accounts/:id/unblock
|
|
* [x] GET /api/v1/accounts/:id/mute
|
|
* [x] GET /api/v1/accounts/:id/unmute
|
|
* [x] GET /api/v1/accounts/:id/lists
|
|
* [x] GET /api/v1/accounts/relationships
|
|
* [x] GET /api/v1/accounts/search
|
|
* [x] POST /api/v1/apps
|
|
* [x] GET /api/v1/blocks
|
|
* [x] GET /api/v1/favourites
|
|
* [x] GET /api/v1/follow_requests
|
|
* [x] POST /api/v1/follow_requests/:id/authorize
|
|
* [x] POST /api/v1/follow_requests/:id/reject
|
|
* [x] POST /api/v1/follows
|
|
* [x] GET /api/v1/instance
|
|
* [x] GET /api/v1/instance/activity
|
|
* [x] GET /api/v1/instance/peers
|
|
* [x] GET /api/v1/lists
|
|
* [x] GET /api/v1/lists/:id/accounts
|
|
* [x] GET /api/v1/lists/:id
|
|
* [x] POST /api/v1/lists
|
|
* [x] PUT /api/v1/lists/:id
|
|
* [x] DELETE /api/v1/lists/:id
|
|
* [x] POST /api/v1/lists/:id/accounts
|
|
* [x] DELETE /api/v1/lists/:id/accounts
|
|
* [x] POST /api/v1/media
|
|
* [x] GET /api/v1/mutes
|
|
* [x] GET /api/v1/notifications
|
|
* [x] GET /api/v1/notifications/:id
|
|
* [x] POST /api/v1/notifications/clear
|
|
* [x] GET /api/v1/reports
|
|
* [x] POST /api/v1/reports
|
|
* [x] GET /api/v1/search
|
|
* [x] GET /api/v1/statuses/:id
|
|
* [x] GET /api/v1/statuses/:id/context
|
|
* [x] GET /api/v1/statuses/:id/card
|
|
* [x] GET /api/v1/statuses/:id/reblogged_by
|
|
* [x] GET /api/v1/statuses/:id/favourited_by
|
|
* [x] POST /api/v1/statuses
|
|
* [x] DELETE /api/v1/statuses/:id
|
|
* [x] POST /api/v1/statuses/:id/reblog
|
|
* [x] POST /api/v1/statuses/:id/unreblog
|
|
* [x] POST /api/v1/statuses/:id/favourite
|
|
* [x] POST /api/v1/statuses/:id/unfavourite
|
|
* [x] GET /api/v1/timelines/home
|
|
* [x] GET /api/v1/timelines/public
|
|
* [x] GET /api/v1/timelines/tag/:hashtag
|
|
* [x] GET /api/v1/timelines/list/:id
|
|
|
|
## Installation
|
|
|
|
```
|
|
$ go get github.com/mattn/go-mastodon
|
|
```
|
|
|
|
## License
|
|
|
|
MIT
|
|
|
|
## Author
|
|
|
|
Yasuhiro Matsumoto (a.k.a. mattn)
|