开始上传 - Powered by MinDoc

简要描述：

某个用户开始上传时，调用此接口获取上传的配置参数

接口版本：

版本号	制定人	制定日期	修订日期
0.0.1	宋德美	2024-06-06

请求URL:

测试环境

https://[天象云企业代码].third-test.suxuantech.com/guangying/client/getUploadToken

正式环境

https://[天象云企业代码].third.suxuantech.com/guangying/client/getUploadToken

其中[天象云企业代码] 为客户在天象云注册的企业代码，也是客户天象云登录地址前缀

请求方式：

POST

请求头：

参数名	是否必须	类型	说明
Content-Type	是	string	请求类型：application/x-www-form-urlencoded
Token	是	string	请求内容签名、登录时返回

请求参数:

参数名	是否必须	类型	说明
mobile	是	string	用户手机号
user_id	是	string	用户id和手机号二选一
upload_id	否	int	上传id，如果想和上次上传合并，则带上上次的上传id
photo_date	否	date	上传日期【一般可以是拍照日期或上传日期】格式：2024-01-01
order_id	否	string	客户订单号
fc	否	int	订单服次
staff_id	否	int	上传者员工id
staff_name	否	string	上传者员工帐号，建议传，否则统计可能会有问题

返回示例:

正确时返回:

{
    "code": 200,
    "data": {
        "driver": "alioss",
        "prefix": "23/21/20240605",
        "expire": 3600,
        "config": {
            "AccessKeyId": "STS.NUTKZd4GPnv3aZNY8dW84L4ze",
            "AccessKeySecret": "A7q7bpR923DbBywAaRL3GhWvyMriNJm5Efxc2GLPffcb",
            "Expiration": "2024-06-05 14:55:19",
            "SecurityToken": "bk6WDM4TvcvOom2m6EriW5S8c/7iSxyuq64tOt6Su76YNvVJn3LODPUlCZ312Qi0ADeSbNP0Aa3rCuKvZZLW2fFGyTOiqAExKAmF/+a9AFg9BIIAA=",
            "bucket": "xxxxxxxxx",
            "endpoint": "oss-cn-xxxx.aliyuncs.com",
            "callbackUrl": "https://suxuan.third-test.suxuantech.com/guangying/callback/alioss"
        },
        "upload_id": 21
    }
}

错误时返回:

{
    "code": 500,
    "msg": "invalid appid"
}

返回参数说明:

参数名	类型	说明
code	int	200为成功，其他为失败
msg	string	如果错误，则为错误的具体信息
data.driver	string	上传驱动名称，minio/alioss/qiniu
data. prefix	string	上传前缀，客户端上传，必须且只能上传到此目录下面，可以加子目录
data. expire	int	此上传token的有效期，单位为秒，一般提前10秒就可以重新再获取，同一个客户，同一天上传，在有效期范围内，可以只用一个token就可以了
data. config	object	上传时用到的配置
data.upload_id	int	本次上传的上传id

备注:

返回参数里的data.config.callbackUrl为回调地址，在客户端上传时，需要增加回调配置，回调参数如下：

etag=${etag}&object=${object}&size=${size}&mimeType=${mimeType}&height=${imageInfo.height}&width=${imageInfo.width}&image_format=${imageInfo.format}&upload_id=${x:upload_id}&baby_id=${x:baby_id}&file_name=${x:file_name}

其中：
upload_id：本次上传的upload_id
baby_id:本次上传的baby_id
file_name:本次上传的文件相对名称，比如返回的上传前缀为a/b/c 然后上传到的目录为d/e/f.jpg则此字段传d/e/f.jpg 文件的真实路径为a/b/c/d/e/f.jpg

作者：宋德美创建时间：2024-06-06 09:34
最后编辑：宋德美更新时间：2024-12-08 14:43