Add Teams endpoints to API

This commit is contained in:
Evan Fiordeliso 2024-03-03 18:00:22 -05:00
parent d44a04b64b
commit 55b5f772fe
4 changed files with 190 additions and 0 deletions

View File

@ -28,6 +28,7 @@ import (
"go.fifitido.net/twitch/api/search" "go.fifitido.net/twitch/api/search"
"go.fifitido.net/twitch/api/streams" "go.fifitido.net/twitch/api/streams"
"go.fifitido.net/twitch/api/subscriptions" "go.fifitido.net/twitch/api/subscriptions"
"go.fifitido.net/twitch/api/teams"
) )
const HelixBaseUrl = "https://api.twitch.tv/helix" const HelixBaseUrl = "https://api.twitch.tv/helix"
@ -60,6 +61,7 @@ type API struct {
Search *search.Search Search *search.Search
Streams *streams.Streams Streams *streams.Streams
Subscriptions *subscriptions.Subscriptions Subscriptions *subscriptions.Subscriptions
Teams *teams.Teams
} }
func New(client *http.Client, baseUrl *url.URL) *API { func New(client *http.Client, baseUrl *url.URL) *API {
@ -91,6 +93,7 @@ func New(client *http.Client, baseUrl *url.URL) *API {
Search: search.New(client, baseUrl), Search: search.New(client, baseUrl),
Streams: streams.New(client, baseUrl), Streams: streams.New(client, baseUrl),
Subscriptions: subscriptions.New(client, baseUrl), Subscriptions: subscriptions.New(client, baseUrl),
Teams: teams.New(client, baseUrl),
} }
} }

View File

@ -0,0 +1,78 @@
package teams
import (
"context"
"encoding/json"
"net/http"
"net/url"
"time"
)
type GetChannelTeamsResponse struct {
// The list of teams that the broadcaster is a member of.
// Returns an empty array if the broadcaster is not a member of a team.
Teams []ChannelTeam `json:"teams"`
}
type ChannelTeam struct {
// The ID that identifies the broadcaster.
BroadcasterID string `json:"broadcaster_id"`
// The broadcasters login name.
BroadcasterLogin string `json:"broadcaster_login"`
// The broadcasters display name.
BroadcasterName string `json:"broadcaster_name"`
// A URL to the teams background image.
BackgroundImageURL string `json:"background_image_url"`
// A URL to the teams banner.
Banner string `json:"banner"`
// The UTC date and time (in RFC3339 format) of when the team was created.
CreatedAt time.Time `json:"created_at"`
// The UTC date and time (in RFC3339 format) of the last time the team was updated.
UpdatedAt time.Time `json:"updated_at"`
// The teams description. The description may contain formatting such as Markdown, HTML, newline (\n) characters, etc.
Info string `json:"info"`
// A URL to a thumbnail image of the teams logo.
ThumbnailURL string `json:"thumbnail_url"`
// The teams name.
TeamName string `json:"team_name"`
// The teams display name.
TeamDisplayName string `json:"team_display_name"`
// An ID that identifies the team.
ID string `json:"id"`
}
// Gets the list of Twitch teams that the broadcaster is a member of.
//
// Requires an app access token or user access token.
func (c *Teams) GetChannelTeams(ctx context.Context, broadcasterID string) (*GetChannelTeamsResponse, error) {
endpoint := c.baseUrl.ResolveReference(&url.URL{Path: "teams/channel", RawQuery: url.Values{"broadcaster_id": {broadcasterID}}.Encode()})
req, err := http.NewRequestWithContext(ctx, http.MethodGet, endpoint.String(), nil)
if err != nil {
return nil, err
}
res, err := c.client.Do(req)
if err != nil {
return nil, err
}
defer res.Body.Close()
var data GetChannelTeamsResponse
if err := json.NewDecoder(res.Body).Decode(&data); err != nil {
return nil, err
}
return &data, nil
}

91
api/teams/get_teams.go Normal file
View File

@ -0,0 +1,91 @@
package teams
import (
"context"
"encoding/json"
"net/http"
"net/url"
"time"
"github.com/google/go-querystring/query"
)
type GetTeamsParams struct {
// The name of the team to get. This parameter and the id parameter are mutually exclusive; you must specify the teams name or ID but not both.
Name *string `url:"name,omitempty"`
// The ID of the team to get. This parameter and the name parameter are mutually exclusive; you must specify the teams name or ID but not both.
ID *string `url:"id,omitempty"`
}
type GetTeamsResponse struct {
// A list that contains the single team that you requested.
Teams []Team `json:"teams"`
}
type Team struct {
// The list of team members.
Users []struct {
// An ID that identifies the team member.
UserID string `json:"user_id"`
// The team members login name.
UserLogin string `json:"user_login"`
// The team members display name.
UserName string `json:"user_name"`
} `json:"users"`
// A URL to the teams background image.
BackgroundImageURL string `json:"background_image_url"`
// A URL to the teams banner.
Banner string `json:"banner"`
// The UTC date and time (in RFC3339 format) of when the team was created.
CreatedAt time.Time `json:"created_at"`
// The UTC date and time (in RFC3339 format) of the last time the team was updated.
UpdatedAt time.Time `json:"updated_at"`
// The teams description. The description may contain formatting such as Markdown, HTML, newline (\n) characters, etc.
Info string `json:"info"`
// A URL to a thumbnail image of the teams logo.
ThumbnailURL string `json:"thumbnail_url"`
// The teams name.
TeamName string `json:"team_name"`
// The teams display name.
TeamDisplayName string `json:"team_display_name"`
// An ID that identifies the team.
ID string `json:"id"`
}
// Gets information about the specified Twitch team. Read More
//
// Requires an app access token or user access token.
func (c *Teams) GetTeams(ctx context.Context, params *GetTeamsParams) (*GetTeamsResponse, error) {
v, _ := query.Values(params)
endpoint := c.baseUrl.ResolveReference(&url.URL{Path: "teams", RawQuery: v.Encode()})
req, err := http.NewRequestWithContext(ctx, http.MethodGet, endpoint.String(), nil)
if err != nil {
return nil, err
}
resp, err := c.client.Do(req)
if err != nil {
return nil, err
}
defer resp.Body.Close()
var data GetTeamsResponse
if err := json.NewDecoder(resp.Body).Decode(&data); err != nil {
return nil, err
}
return &data, nil
}

18
api/teams/teams.go Normal file
View File

@ -0,0 +1,18 @@
package teams
import (
"net/http"
"net/url"
)
type Teams struct {
client *http.Client
baseUrl *url.URL
}
func New(client *http.Client, baseUrl *url.URL) *Teams {
return &Teams{
client: client,
baseUrl: baseUrl,
}
}