errors

var (
	// ErrMissingAPIKey API Key缺失
	ErrMissingAPIKey = &SteamError{
		Type:    ErrTypeParam,
		Code:    10001,
		Message: "steam api key is missing",
		Err:     errors.New("steam api key is missing"),
	}

	// ErrInvalidSteamID 无效SteamID
	ErrInvalidSteamID = &SteamError{
		Type:    ErrTypeParam,
		Code:    10002,
		Message: "invalid steam id",
		Err:     errors.New("invalid steam id"),
	}

	// ErrInvalidAppID 无效AppID
	ErrInvalidAppID = &SteamError{
		Type:    ErrTypeParam,
		Code:    10003,
		Message: "invalid app id (app id cannot be 0)",
		Err:     errors.New("invalid app id"),
	}

	// ErrAPIResponse 响应解析失败
	ErrAPIResponse = &SteamError{
		Type:    ErrTypeParse,
		Code:    20001,
		Message: "failed to parse steam api response",
		Err:     errors.New("json unmarshal failed"),
	}

	// ErrAPIQuotaExceeded API额度超限
	ErrAPIQuotaExceeded = &SteamError{
		Type:    ErrTypeRequest,
		Code:    30001,
		Message: "steam api quota exceeded (429)",
		Err:     errors.New("api rate limit exceeded"),
	}

	// ErrRequestFailed 请求失败
	ErrRequestFailed = &SteamError{
		Type:    ErrTypeRequest,
		Code:    30002,
		Message: "steam api request failed",
		Err:     errors.New("http request failed"),
	}

	// ErrAchievementFailed 成就查询失败
	ErrAchievementFailed = &SteamError{
		Type:    ErrTypeAPI,
		Code:    40001,
		Message: "steam api return success=false (achievements not found or permission denied)",
		Err:     errors.New("achievements query failed"),
	}
)