媒体文件上传结果上报

2024-09-09
暂无评分

上报文件上传结果

POST /media/api/v1/workspaces/{workspace_id}/upload-callback

Parameters

NameInTypeRequiredDescription
workspace_idpathstringtrue工作空间id
x-auth-tokenheaderstringtrue访问令牌
-bodymedia.UploadCallbackInputtrue

Responses

StatusMeaningDescriptionSchema
200OKopen in new windowOKmedia.UploadCallbackOutput

Example responses

{
  "code":0,
  "message":"success",
  "data":{
    "object_key":"5asjwu24-2a18-4b4b-86f9-3a678da0bf4d/example.jpg"
  }
}

Schemas

media.UploadCallbackInput

{
  "result": 0,
  "ext": {
    "file_group_id": "string",
    "drone_model_key": "string",
    "is_original": true,
    "payload_model_key": "string",
    "tinny_fingerprint": "string",
    "sn": "string"
  },
  "fingerprint": "string",
  "metadata": {
    "absolute_altitude": 0,
    "created_time": "string",
    "gimbal_yaw_degree": 0,
    "relative_altitude": 0,
    "shoot_position": {
      "lat": 0,
      "lng": 0
    }
  },
  "name": "string",
  "object_key": "string",
  "path": "string",
  "sub_file_type": 0
}

Properties

NameTypeRequiredRestrictionsDescription
resultinttruenone文件上传到存储桶是否成功,非0代表失败
extmedia.MediaFilefalsenone文件关联的扩展字段
fingerprintstringfalsenone文件指纹
metadatamedia.MetaDatafalsenone媒体元数据
namestringtruenone文件的名称
object_keystringtruenone文件在对象存储桶的key
pathstringtruenone文件的业务路径
sub_file_typeintegerfalsenone当文件为图片的时候生效
* 0 - 普通图片
* 1 - 全景图

media.MediaFile

{
  "file_group_id": "string",
  "drone_model_key": "string",
  "is_original": true,
  "payload_model_key": "string",
  "tinny_fingerprint": "string",
  "sn": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
file_group_idstringfalsenone文件分组id
drone_model_keystringfalsenone飞机产品枚举值
is_originalbooleanfalsenone是否为原图
payload_model_keystringfalsenone负载产品枚举值
tinny_fingerprintstringfalsenone精简指纹
snstringfalsenone设备序列号

media.MetaData

{
  "absolute_altitude": 0,
  "created_time": "string",
  "gimbal_yaw_degree": 0,
  "relative_altitude": 0,
  "shoot_position": {
    "lat": 0,
    "lng": 0
  }
}

Properties

NameTypeRequiredRestrictionsDescription
absolute_altitudefloatfalsenone拍摄绝对高度(m)
created_timestringfalsenone媒体拍摄时间(iso 8601)
gimbal_yaw_degreefloatfalsenone云台偏航角
relative_altitudefloatfalsenone拍摄相对高度(m)
shoot_positionobjectfalsenone拍摄位置
» latfloatfalsenone拍摄位置纬度
» lngfloatfalsenone拍摄位置经度

media.UploadCallbackOutput

{
  "code": 0,
  "data": {
    "object_key": "string"
  },
  "message": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
codeintegerfalsenone错误码
datamedia.UploadCallbackOutputDatafalsenonenone
messagestringfalsenone错误描述

media.UploadCallbackOutputData

{
  "object_key": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
object_keystringfalsenone文件在对象存储桶的key
若您对文档有意见或疑惑,点击可快速反馈,我们会与您联系。