pcs

type AddTaskOptions struct {
	// 请求失效时间，如果有，则会校验
	Expires int `url:"expires,omitempty"`

	// 下载后的文件保存路径
	SavePath string `url:"save_path"`

	// 源文件的URL
	SourceURL string `url:"source_url"`

	// 下载限速，默认不限速
	RateLimit int `url:"rate_limit,omitempty"`

	// 下载超时时间，默认3600秒
	Timeout int `url:"timeout,omitempty"`

	// 下载完毕后的回调，默认为空
	Callback string `url:"callback,omitempty"`
}

type CancelTaskOptions struct {
	// 请求失效时间，如果有，则会校验
	Expires int `url:"expires,omitempty"`

	// 要取消的任务ID号
	TaskId string `url:"task_id"`
}

type Client struct {
	BaseURL     *url.URL
	UploadURL   *url.URL
	DownloadURL *url.URL

	UserAgent   string
	AccessToken string
	// contains filtered or unexported fields
}

type ErrorResponse struct {
	Response *http.Response // HTTP response that caused this error
	Message  string         `json:"error_msg"`  // error message
	Code     int            `json:"error_code"` // error code
}

type FTPair struct {
	From string `json:"from"`
	To   string `json:"to"`
}

type File struct {
	Path  string `json:"path"`  // 文件的绝对路径
	Size  uint64 `json:"size"`  // 文件大小（以字节为单位）
	Ctime uint64 `json:"ctime"` // 文件创建时间
	Mtime uint64 `json:"mtime"` // 文件修改时间
	Md5   string `json:"md5"`   // 文件的md5签名
	FsId  uint64 `json:"fs_id"` // 文件在PCS的临时唯一标识ID
	IsDir uint   `json:"isdir"` // 是否是目录的标识符: “0”为文件, “1”为目录
}

type FileMeta struct {
	*File
	BlockList   string `json:"block_list"`
	IfHasSubDir uint   `json:"ifhassubdir"`
}

type FileOptions struct {
	// 上传文件路径（含上传的文件名称)。
	Path string `url:"path"`

	// 可选值：
	// overwrite：表示覆盖同名文件；
	// newcopy：表示生成文件副本并进行重命名，命名规则为“文件名_日期.后缀”。
	OnDup string `url:"ondup,omitempty"`
}

type ListFilesOptions struct {
	// 需要list的目录，以/开头的绝对路径。
	Path string `url:"path"`

	// “asc”或“desc”，缺省采用降序排序。
	// asc（升序）
	// desc（降序）
	Order string `url:"order,omitempty"`

	// 排序字段，缺省根据文件类型排序：
	// time（修改时间）
	// name（文件名）
	// size（大小，注意目录无大小）
	By string `url:"by,omitempty"`

	// 返回条目控制，参数格式为：n1-n2。
	// 返回结果集的[n1, n2)之间的条目，缺省返回所有条目；n1从0开始。
	Limit string `url:"limit,omitempty"`
}

type ListRecycleOptions struct {
	// 返回条目的起始值，缺省值为0
	Start int `url:"start,omitempty"`

	// 返回条目的长度，缺省值为1000
	Limit int `url:"limit,omitempty"`
}

type ListRecycleResponse struct {
	List []*File `json:"list"`
}

type ListStreamOptions struct {
	// 类型分为video、audio、image及doc四种
	Type string `url:"type"`

	// 返回条目控制起始值，缺省值为0
	Start string `url:"start,omitempty"`

	// 返回条目控制长度，缺省为1000，可配置
	Limit string `url:"limit,omitempty"`

	// 需要过滤的前缀路径，如：/apps/album
	FilterPath string `url:"filter_path,omitempty"`
}

type ListTaskOptions struct {
	// 请求失效时间，如果有，则会校验
	Expires int `url:"expires,omitempty"`

	// 查询任务起始位置，默认为0
	Start int `url:"start,omitempty"`

	// 设定返回任务数量，默认为10
	Limit int `url:"limit,omitempty"`

	// 0：降序，默认值
	// 1：升序
	Asc int `url:"asc,omitempty"`

	// 源地址URL，默认为空
	SourceURL string `url:"source_url,omitempty"`

	// 文件保存路径，默认为空
	SavePath string `url:"save_path,omitempty"`

	// 任务创建时间，默认为空
	CreateTime int `url:"create_time,omitempty"`

	// 任务状态，默认为空
	Status int `url:"status,omitempty"`

	// 是否需要返回任务信息:
	// 0：不需要
	// 1：需要，默认为1
	NeedTaskInfo int `url:"need_task_info,omitempty"`
}

type MoveCopyResponse struct {
	Extra struct {
		List []struct {
			To   string `json:"to"`
			From string `json:"from"`
		} `json:"list"`
	} `json:"extra"`
}

type QueryTaskOptions struct {
	// 请求失效时间，如果有，则会校验
	Expires int `url:"expires,omitempty"`

	// 要查询的任务ID信息，如：1,2,3,4
	TaskIds string `url:"task_ids"`

	// 0：查任务信息
	// 1：查进度信息，默认为1
	OpType int `url:"op_type"`
}

type Quota struct {
	Quota uint64 `json:"quota"`
	Used  uint64 `json:"used"`
}

type RapiduUploadOptions struct {
	// 上传文件的全路径名
	Path string `url:"path"`

	// 待秒传的文件长度
	ContentLength int `url:"content-length"`

	// 待秒传的文件的MD5
	ContentMd5 string `url:"content-md5"`

	// 待秒传文件校验段的MD5
	SliceMd5 string `url:"slice-md5"`

	// 待秒传文件CRC32
	ContentCrc32 string `url:"content-crc32"`

	// overwrite：表示覆盖同名文件；
	// newcopy：表示生成文件副本并进行重命名，命名规则为“文件名_日期.后缀”。
	Ondup string `url:"ondup,omitempty"`
}

type RestoreResponse struct {
	Extra struct {
		List []struct {
			FsID string `json:"fs_id"`
		} `json:"list"`
	} `json:"extra"`
}

type SearchOptions struct {
	// 需要检索的目录
	Path string `url:"path"`

	// 关键词
	Word string `url:"wd"`

	// 是否递归
	// “0”表示不递归
	// “1”表示递归
	// 缺省为“0”
	Re string `url:"re,omitempty"`
}

type StreamFile struct {
	Total uint    `json:"total"`
	Start uint    `json:"start"`
	Limit uint    `json:"limit"`
	List  []*File `json:"list"`
}

type ThumbnailOptions struct {
	// 源图片的路径
	Path string `url:"path"`

	// 缩略图的质量，默认为“100”，取值范围(0,100]
	Quality int32 `url:"quality,omitempty"`

	// 指定缩略图的高度，取值范围为(0,1600]
	Height int `url:"height"`

	// 指定缩略图的宽度，取值范围为(0,1600]
	Width int `url:"width"`
}