确认上传
简要描述
- 在文件直传成功后通知服务端完成上传,生成可访问的对象地址。
请求方式
post
请求 URL
{API_ADDRESS}/object/complete_form_data
Header
| header 名 | 示例值 | 选填 | 类型 | 说明 |
|---|---|---|---|---|
| operationID | 1646445464564 | 必填 | string | 用于全局链路追踪,建议使用时间戳,在每个请求中独立 |
| token | eyJhbxxxx3Xs | 必填 | string | 管理员 token |
请求参数示例
{
"id": "upload-task-id"
}
| 字段名 | 选填 | 类型 | 说明 |
|---|---|---|---|
| id | 必填 | string | 初始化阶段返回的 ID |
成功返回示例
{
"errCode": 0,
"errMsg": "",
"errDlt": "",
"data": {
"url": "https://cdn.example.com/avatar.png"
}
}
成功返回示例的参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| errCode | int | 错误码,0 表示成功 |
| errMsg | string | 错误简要信息,为空 |
| errDlt | errDlt | 错误详细信息,为空 |
| data | object | 通用数据对象,具体结构见下方 |
| url | string | 文件在业务端可访问的最终地址 |
仅在使用
initiate_form_data返回的凭证完成直传并确认成功后,服务端才会返回url,可将其写入业务数据或下发给客户端。
失败返回示例
{
"errCode": 1004,
"errMsg": "RecordNotFoundError",
"errDlt": ": [1004]RecordNotFoundError"
}
失败返回示例的参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| errCode | int | 错误码,具体查看全局错误码文档 |
| errMsg | string | 错误简要信息 |
| errDlt | errDlt | 错误详细信息 |