authentication.md

Get authorize endpoint

	client, _ := gokick.NewClient(&gokick.ClientOptions{
		ClientID: "client-id",
	})

	response, _ := client.GetAuthorizeEndpoint(
		"http://localhost:3000/oauth/kick/callback",
		"custom-state",
		"custome-code-challenge",
		[]gokick.Scope{gokick.ScopeUserRead, gokick.ScopeChannelRead},
	)
	spew.Dump("response", response)

output

(string) (len=8) "response"
(string) (len=347) "https://id.kick.com/oauth/authorize?client_id=client-id&response_type=code&redirect_uri=http%3A%2F%2Flocalhost%3A3000%2Foauth%2Fkick%2Fcallback&state=custom-state&scope=user%3Aread+channel%3Aread&code_challenge=custom-code-challenge&code_challenge_method=S256"

Get token

	client, _ := gokick.NewClient(&gokick.ClientOptions{
		ClientID:     "01JMFMxxx",
		ClientSecret: "894b8xxx",
	})

	response, _ := client.GetToken(
		context.Background(),
		"http://localhost:3000/oauth/kick/callback",
		"code",
		"code-verifier",
	)

	spew.Dump("response", response)

output

(string) (len=10) "response"
(gokick.TokenResponse) {
 AccessToken: (string) (len=48) "MDJMMWNMxxxxx",
 TokenType: (string) (len=6) "Bearer",
 ExpiresIn: (int) 7200,
 Scope: (string) (len=79) "user:read chat:write channel:read channel:write streamkey:read events:subscribe",
 RefreshToken: (string) (len=48) "MGNMxxxx"
}

Get app access token

	client, _ := gokick.NewClient(&gokick.ClientOptions{
		ClientID:     "01JMFxxxxx",
		ClientSecret: "894b81xxxxx",
	})

	response, _ := client.GetAppAccessToken(
		context.Background(),
	)

	spew.Dump("response", response)

output

(string) (len=8) "response"
(gokick.AppTokenResponse) {
 AccessToken: (string) (len=48) "YTDKOTHxxxxx",
 TokenType: (string) (len=6) "Bearer",
 ExpiresIn: (int) 5184000
}

Refresh token

	client, _ := gokick.NewClient(&gokick.ClientOptions{
		ClientID:        "01JMFMAxxxx",
		ClientSecret:    "894b8190xxxxxx",
	})

	response, _ := client.RefreshToken(context.Background(), "your-refresh-token")

	spew.Dump("response", response)

output

(string) (len=8) "response"
(gokick.TokenResponse) {
 AccessToken: (string) (len=48) "ZJYZM2QYZMIxxxxx",
 TokenType: (string) (len=6) "Bearer",
 ExpiresIn: (int) 7200,
 Scope: (string) (len=79) "user:read chat:write channel:read channel:write streamkey:read events:subscribe",
 RefreshToken: (string) (len=48) "MJJIYWU2ZMMTNZxxxx"
}

Revoke token

	client, _ := gokick.NewClient(&gokick.ClientOptions{
		ClientID:     "01JMFMAxxxxx",
		ClientSecret: "894b81xxxxx",
	})

	err := client.RevokeToken(
		context.Background(),
		gokick.TokenTypeAccess,
		"MGNMZJxxxx",
	)

Token Management

Set App Access Token

	client, _ := gokick.NewClient(&gokick.ClientOptions{
		ClientID:     "01JMFxxxxx",
		ClientSecret: "894b81xxxxx",
	})

	client.SetAppAccessToken("YTDKOTHxxxxx")

Set User Access Token

	client, _ := gokick.NewClient(&gokick.ClientOptions{
		ClientID:     "01JMFxxxxx",
		ClientSecret: "894b81xxxxx",
	})

	client.SetUserAccessToken("MDJMMWNMxxxxx")

Set User Refresh Token

	client, _ := gokick.NewClient(&gokick.ClientOptions{
		ClientID:     "01JMFxxxxx",
		ClientSecret: "894b81xxxxx",
	})

	client.SetUserRefreshToken("MGNMxxxx")

Auto Token Refresh

The client can automatically refresh user access tokens when they expire. To enable this feature, you need to provide ClientID, ClientSecret, and UserRefreshToken in the client options.

	client, _ := gokick.NewClient(&gokick.ClientOptions{
		ClientID:        "01JMFMAxxxx",
		ClientSecret:    "894b8190xxxxxx",
		UserAccessToken: "current-access-token",
		UserRefreshToken: "your-refresh-token",
	})

	// Optionally, set a callback to be notified when tokens are refreshed
	client.OnUserAccessTokenRefreshed(func(accessToken, refreshToken string) {
		// Save the new tokens to your storage
		fmt.Printf("New access token: %s\n", accessToken)
		fmt.Printf("New refresh token: %s\n", refreshToken)
	})

	// When making API calls, if the access token expires, the client will
	// automatically refresh it and retry the request
	response, err := client.GetChannels(context.Background(), gokick.NewChannelListFilter())