httpclient

Sep 25, 2025

Changes in this version

type ClientOptions

+ HeaderEnricher func(ctx context.Context, req *http.Request)

Sep 10, 2025

Changes in this version

type Client

+ func (c *Client) PostStream(ctx context.Context, path string, body any) (*http.Response, error)

Apr 2, 2025

Changes in this version

+ type Auth interface

+ Token func(ctx context.Context) (string, error)

+ func NewJWTAuth(client *JWTOAuthClient, opt *GetJWTAccessTokenReq) Auth

+ func NewTokenAuth(accessToken string) Auth

+ type Backoff struct

+ func NewBackoff(baseDelay, maxDelay time.Duration) *Backoff

+ func (b *Backoff) Retry(ctx context.Context, f func() error, retryTimes int) error

+ func (b *Backoff) Wait(ctx context.Context, currentRetryTimes int) error

+ type BaseResponse struct

+ Code int

+ LogID string

+ Msg string

+ func (b *BaseResponse) GetCode() int

+ func (b *BaseResponse) GetLogID() string

+ func (b *BaseResponse) GetMsg() string

+ func (b *BaseResponse) SetLogID(logID string)

+ type Client struct

+ func NewClient(baseURL string, httpClient HTTPClient, auth Auth, options *ClientOptions) *Client

+ func (c *Client) Get(ctx context.Context, path string, params map[string]string, ...) error

+ func (c *Client) GetWithRetry(ctx context.Context, path string, params map[string]string, ...) error

+ func (c *Client) Post(ctx context.Context, path string, body any, resp OpenAPIResponse) error

+ func (c *Client) PostWithRetry(ctx context.Context, path string, body any, resp OpenAPIResponse, ...) error

+ func (c *Client) UploadFile(ctx context.Context, path string, fileName string, reader io.Reader, ...) error

+ type ClientOptions struct

+ Timeout time.Duration

+ UploadTimeout time.Duration

+ type GetJWTAccessTokenReq struct

+ AccountID *int64

+ Scope *Scope

+ SessionName *string

+ TTL time.Duration

+ type GrantType string

+ const GrantTypeAuthorizationCode

+ const GrantTypeDeviceCode

+ const GrantTypeJWTCode

+ const GrantTypeRefreshToken

+ func (r GrantType) String() string

+ type HTTPClient interface

+ Do func(*http.Request) (*http.Response, error)

+ type JWTOAuthClient struct

+ func NewJWTOAuthClient(param NewJWTOAuthClientParam, opts ...OAuthClientOption) (*JWTOAuthClient, error)

+ func (c *JWTOAuthClient) GetAccessToken(ctx context.Context, opts *GetJWTAccessTokenReq) (*OAuthToken, error)

+ type NewJWTOAuthClientParam struct

+ ClientID string

+ PrivateKeyPEM string

+ PublicKey string

+ TTL time.Duration

+ type OAuthClient struct

+ type OAuthClientOption func(*oauthOption)

+ func WithAuthBaseURL(baseURL string) OAuthClientOption

+ func WithAuthHttpClient(client HTTPClient) OAuthClientOption

+ func WithAuthWWWURL(wwwURL string) OAuthClientOption

+ type OAuthToken struct

+ AccessToken string

+ ExpiresIn int64

+ RefreshToken string

+ type OpenAPIResponse interface

+ GetCode func() int

+ GetLogID func() string

+ GetMsg func() string

+ SetLogID func(string)

+ type Scope struct

+ AccountPermission *ScopeAccountPermission

+ AttributeConstraint *ScopeAttributeConstraint

+ type ScopeAccountPermission struct

+ PermissionList []string

+ type ScopeAttributeConstraint struct

+ ConnectorBotChatAttribute *ScopeAttributeConstraintConnectorBotChatAttribute

+ type ScopeAttributeConstraintConnectorBotChatAttribute struct

+ BotIDList []string