78d8d7fc43
For my archival purposes, I like to keep the raw API JSON around as it often contains things not picked up by the various objects. e.g. getting a status from my Akkoma instance contains a whole `pleroma` extension block that's not reflected in `mastodon.Status`. Maybe this should be gated by an option when creating the `Client` since it's probably only relevant to 1% of library users. |
||
|---|---|---|
| .github | ||
| cmd/mstdn | ||
| testdata | ||
| .gitignore | ||
| LICENSE | ||
| README.md | ||
| accounts.go | ||
| accounts_test.go | ||
| apps.go | ||
| apps_test.go | ||
| compat.go | ||
| example_test.go | ||
| filters.go | ||
| filters_test.go | ||
| go.mod | ||
| go.sum | ||
| go.test.sh | ||
| helper.go | ||
| helper_test.go | ||
| instance.go | ||
| instance_test.go | ||
| lists.go | ||
| lists_test.go | ||
| mastodon.go | ||
| mastodon_test.go | ||
| notification.go | ||
| notification_test.go | ||
| polls.go | ||
| polls_test.go | ||
| report.go | ||
| report_test.go | ||
| status.go | ||
| status_test.go | ||
| streaming.go | ||
| streaming_test.go | ||
| streaming_ws.go | ||
| streaming_ws_test.go | ||
| unixtime.go | ||
README.md
go-mastodon
Usage
Application
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
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
- GET /api/v1/accounts/:id
- GET /api/v1/accounts/verify_credentials
- PATCH /api/v1/accounts/update_credentials
- GET /api/v1/accounts/:id/followers
- GET /api/v1/accounts/:id/following
- GET /api/v1/accounts/:id/statuses
- POST /api/v1/accounts/:id/follow
- POST /api/v1/accounts/:id/unfollow
- GET /api/v1/accounts/:id/block
- GET /api/v1/accounts/:id/unblock
- GET /api/v1/accounts/:id/mute
- GET /api/v1/accounts/:id/unmute
- GET /api/v1/accounts/:id/lists
- GET /api/v1/accounts/relationships
- GET /api/v1/accounts/search
- GET /api/v1/apps/verify_credentials
- GET /api/v1/bookmarks
- POST /api/v1/apps
- GET /api/v1/blocks
- GET /api/v1/conversations
- DELETE /api/v1/conversations/:id
- POST /api/v1/conversations/:id/read
- GET /api/v1/favourites
- GET /api/v1/filters
- POST /api/v1/filters
- GET /api/v1/filters/:id
- PUT /api/v1/filters/:id
- DELETE /api/v1/filters/:id
- GET /api/v1/follow_requests
- POST /api/v1/follow_requests/:id/authorize
- POST /api/v1/follow_requests/:id/reject
- POST /api/v1/follows
- GET /api/v1/instance
- GET /api/v1/instance/activity
- GET /api/v1/instance/peers
- GET /api/v1/lists
- GET /api/v1/lists/:id/accounts
- GET /api/v1/lists/:id
- POST /api/v1/lists
- PUT /api/v1/lists/:id
- DELETE /api/v1/lists/:id
- POST /api/v1/lists/:id/accounts
- DELETE /api/v1/lists/:id/accounts
- POST /api/v1/media
- GET /api/v1/mutes
- GET /api/v1/notifications
- GET /api/v1/notifications/:id
- POST /api/v1/notifications/:id/dismiss
- POST /api/v1/notifications/clear
- POST /api/v1/push/subscription
- GET /api/v1/push/subscription
- PUT /api/v1/push/subscription
- DELETE /api/v1/push/subscription
- GET /api/v1/reports
- POST /api/v1/reports
- GET /api/v2/search
- GET /api/v1/statuses/:id
- GET /api/v1/statuses/:id/context
- GET /api/v1/statuses/:id/card
- GET /api/v1/statuses/:id/history
- GET /api/v1/statuses/:id/reblogged_by
- GET /api/v1/statuses/:id/source
- GET /api/v1/statuses/:id/favourited_by
- POST /api/v1/statuses
- PUT /api/v1/statuses/:id
- DELETE /api/v1/statuses/:id
- POST /api/v1/statuses/:id/reblog
- POST /api/v1/statuses/:id/unreblog
- POST /api/v1/statuses/:id/favourite
- POST /api/v1/statuses/:id/unfavourite
- POST /api/v1/statuses/:id/bookmark
- POST /api/v1/statuses/:id/unbookmark
- GET /api/v1/timelines/home
- GET /api/v1/timelines/public
- GET /api/v1/timelines/tag/:hashtag
- GET /api/v1/timelines/list/:id
- GET /api/v1/streaming/user
- GET /api/v1/streaming/public
- GET /api/v1/streaming/hashtag?tag=:hashtag
- GET /api/v1/streaming/hashtag/local?tag=:hashtag
- GET /api/v1/streaming/list?list=:list_id
- GET /api/v1/streaming/direct
Installation
go install github.com/mattn/go-mastodon@latest
License
MIT
Author
Yasuhiro Matsumoto (a.k.a. mattn)