上传文件初始化

优质

小牛编辑

120浏览

2023-12-01

接口说明

上传文件初始化
如需调用，请访问开发者文档来查看详细的接口使用说明
该接口仅开放给已获取SDK的开发者
如开启https功能，请求地址的协议应改为https，如：https://www.example.com/wish3dearth/api/access/v1.0.0/getLicenseInfo

API地址

POST /wish3dearth/api/material/upload/v1.0.0/startUploadInit

是否需要登录

是

请求字段说明

参数	类型	请求类型	是否必须	说明
token	string	header	是	当前登录用户的TOKEN
fileName	string	query	是	素材名(带后缀)
materialType	string	formData	否	素材类型
dataType	string	formData	否	数据类型（如osgb，lrp）
extra	string	query	否	其他信息JSON sExtra.position=file.position;//经纬度坐标或平面坐标 sExtra.epsgCode=file.epsgCode;//坐标系编码 sExtra.hasProjection=file.hasProjection;//是否有投影 sExtra.prjFilePath=file.prjFilePath;//prj路径 sExtra["3DTiles"] = true;

响应字段说明

参数	类型	说明
materialId	string	素材ID
md5_arr	string	逗号分隔的文件分片md5校验码

响应成功示例

{
  "code": 0,
  "data": {
    "md5_arr": "",
    "materialId": "63efa11969fa4d1ca76a81b5c7be82f5"
  },
  "message": "成功"
}

响应失败示例

{
  "code": 500,
  "message": "未知错误，请及时联系管理人员进行处理"
}

响应接受类型

application/json

响应状态码

HTTP状态码	原因
0	成功
200	OK
201	Created
401	Unauthorized
403	Forbidden
404	Not Found
10000	token不能为空
10001	token已失效,请重新登录
14052	素材原文件名为空
14053	素材后缀不能为空
14054	数据类型不能为空
99998	非法请求
99999	服务器异常

示例代码

$.ajax({

    url: '/wish3dearth/api/material/upload/v1.0.0/startUploadInit',

    type: 'POST',

    data: 'token=&fileName=&materialType=&dataType=&extra=',

    dataType: 'text',

    cache: false,

    contentType: 'application/json',

    xhrFields: {

        withCredentials: true

    },

    crossDomain: true,

    success:function(data){

        // 成功返回值

    },

    error:function(XMLHttpRequest, textStatus, errorThrown){

    

    }

})