client

type APIError struct {
	Code    int
	Message string
	Err     error
}

type Client struct {
	// APIRootURL APIのリクエスト先URLプレフィックス
	APIRootURL string
	// contains filtered or unexported fields
}

type ClientParam func(*ClientParams)

type ClientParams struct {
	// APIのリクエスト先URLプレフィックス
	APIRootURL string
	// APIキー群
	Token  string
	Secret string
	// クライアントから送られるユーザエージェント
	UserAgent string
	// Options HTTPクライアント関連オプション
	Options *Options
	// Profile usacloud互換プロファイル名
	Profile string
	// usacloud互換プロファイルからの設定読み取りを無効化
	DisableProfile bool
	// 環境変数からの設定読み取りを無効化
	DisableEnv bool
	// カスタムHTTPクライアント (例: httptest.NewServer().Client())
	HTTPClient *http.Client
}

type Factory struct {
	// contains filtered or unexported fields
}

type HttpRequestDoer interface {
	Do(req *http.Request) (*http.Response, error)
}

type Options struct {
	// AccessToken APIキー:トークン
	AccessToken string
	// AccessTokenSecret APIキー:シークレット
	AccessTokenSecret string

	// AcceptLanguage APIリクエスト時のAccept-Languageヘッダーの値
	AcceptLanguage string

	// Gzip APIリクエストでgzipを有効にするかのフラグ
	Gzip bool

	// HttpClient APIリクエストで使用されるHTTPクライアント
	//
	// 省略した場合はhttp.DefaultClientが使用される
	HttpClient *http.Client

	// HttpRequestTimeout HTTPリクエストのタイムアウト秒数
	HttpRequestTimeout int
	// HttpRequestRateLimit 1秒あたりの上限リクエスト数
	HttpRequestRateLimit int

	// RetryMax リトライ上限回数
	RetryMax int

	// RetryWaitMax リトライ待ち秒数(最大)
	RetryWaitMax int
	// RetryWaitMin リトライ待ち秒数(最小)
	RetryWaitMin int

	// UserAgent ユーザーエージェント
	UserAgent string

	// Trace HTTPリクエスト/レスポンスのトレースログ(ダンプ)出力
	Trace bool
	// TraceOnlyError HTTPリクエスト/レスポンスのトレースログ(ダンプ)出力で非200番台のレスポンス時のみ出力する
	TraceOnlyError bool

	// RequestCustomizers リクエスト前に*http.Requestのカスタマイズを行うためのfunc
	RequestCustomizers []sacloudhttp.RequestCustomizer

	// CheckRetryFunc リトライすべきか判定するためのfunc
	//
	// CheckRetryStatusCodesより優先される
	CheckRetryFunc func(ctx context.Context, resp *http.Response, err error) (bool, error)

	// CheckRetryStatusCodes リトライすべきステータスコード
	//
	// CheckRetryFuncが指定されていない、かつこの値が指定されている場合、指定のステータスコードを持つレスポンスを受け取ったらリトライする
	CheckRetryStatusCodes []int
	// contains filtered or unexported fields
}