71 lines
2.3 KiB
Go
71 lines
2.3 KiB
Go
package raids
|
||
|
||
import (
|
||
"context"
|
||
"encoding/json"
|
||
"fmt"
|
||
"net/http"
|
||
|
||
"github.com/google/go-querystring/query"
|
||
"go.fifitido.net/twitch/api/endpoint"
|
||
)
|
||
|
||
type StartARaidParams struct {
|
||
// The ID of the broadcaster that’s sending the raiding party. This ID must match the user ID in the user access token.
|
||
FromBroadcasterID string `url:"from_broadcaster_id"`
|
||
|
||
// The ID of the broadcaster to raid.
|
||
ToBroadcasterID string `url:"to_broadcaster_id"`
|
||
}
|
||
|
||
type StartARaidResponse struct {
|
||
// A list that contains a single object with information about the pending raid.
|
||
Data []struct {
|
||
// The UTC date and time, in RFC3339 format, of when the raid was requested.
|
||
CreatedAt string `json:"created_at"`
|
||
// A Boolean value that indicates whether the channel being raided contains mature content.
|
||
IsMature bool `json:"is_mature"`
|
||
} `json:"data"`
|
||
}
|
||
|
||
// Raid another channel by sending the broadcaster’s viewers to the targeted channel.
|
||
//
|
||
// When you call the API from a chat bot or extension,
|
||
// the Twitch UX pops up a window at the top of the chat room that identifies the number of viewers in the raid.
|
||
// The raid occurs when the broadcaster clicks Raid Now or after the 90-second countdown expires.
|
||
//
|
||
// To determine whether the raid successfully occurred, you must subscribe to the Channel Raid event.
|
||
// For more information, see Get notified when a raid begins: https://dev.twitch.tv/docs/api/raids#get-notified-when-a-raid-begins
|
||
//
|
||
// To cancel a pending raid, use the Cancel a raid endpoint.
|
||
//
|
||
// Rate Limit: The limit is 10 requests within a 10-minute window.
|
||
//
|
||
// Requires a user access token that includes the channel:manage:raids scope.
|
||
func (r *Raids) StartARaid(ctx context.Context, params *StartARaidParams) (*StartARaidResponse, error) {
|
||
v, _ := query.Values(params)
|
||
|
||
req, err := http.NewRequestWithContext(ctx, http.MethodPost, endpoint.Make(r.baseUrl, "raids", v), nil)
|
||
if err != nil {
|
||
return nil, err
|
||
}
|
||
|
||
res, err := r.client.Do(req)
|
||
if err != nil {
|
||
return nil, err
|
||
}
|
||
defer res.Body.Close()
|
||
|
||
statusOK := res.StatusCode >= 200 && res.StatusCode < 300
|
||
if !statusOK {
|
||
return nil, fmt.Errorf("failed to start a raid (%d)", res.StatusCode)
|
||
}
|
||
|
||
var data StartARaidResponse
|
||
if err := json.NewDecoder(res.Body).Decode(&data); err != nil {
|
||
return nil, err
|
||
}
|
||
|
||
return &data, nil
|
||
}
|