捞3D api说明

满足企业用户对3D内容在线显示的各种定制化需求

模型上传

请求地址

http://www.lao3d.com/openApi/uploadModel

参数

参数 参数说明
obj 上传文件
appkey appkey
modelName 模型名
libraryName 模型库名
tags 标签(空格分开)
priviledge 权限(0代表对所有人公开,1代表仅对我自己公开,2仅对我关注的人公开)
icon(可选) 缩略图(支持JPG、JPEG、PNG或BMP文件)
introduce(可选) 介绍

示例代码

<form method="post" enctype="multipart/form-data" action="http://www.lao3d.com/openApi/uploadModel"/>
    文件<input type="file" name="obj" multiple="true"/>
    用户名<input type="text" name="userName"/>
    appkey<input type="text" name="appkey"/>
    模型名<input type="text" name="modelName"/>
    模型库名<input type="text" name="libraryName"/>
    标签(空格分隔)<input type="text" name="tags"/>
    权限<input type="text" name="priviledge"/>
    缩略图<input type="file" name="icon"/>
    介绍<input type="text" name="introduce"/>
    <input type="submit" value="Submit"/>
</form>

返回参数说明

参数名称 参数说明
ret 返回码
modelid 如果如果正确,返回所上传的模型ID
msg 如果错误,返回错误信息

返回代码说明

ret = 0: 正确返回
ret > 0: 调用openAPI时发生错误,需要开发者进行相应的处理。
错误代码 描述
0 正确返回
2 APPKEY被禁用(用户被禁用)
3 如果错误,返回错误信息
1001 APPKEY错误
1002 模型库不存在
1003 模型名包含非法字符
1004 标签名包含非法字符
1003 模型名包含非法字符
1005 模型介绍包含非法字符

正确返回示例

{
  "ret":0,
  "modelid":12345
}

错误返回示例

{
  "ret":1001,
  "msg":"APPKEY错误"
}

获取模型信息

请求地址

http://www.lao3d.com/openApi/getModelInfo

参数

参数 参数说明
modelId 模型Id
appkey appkey

返回参数说明

参数名称 参数说明
ret 返回码
msg 如果错误,返回错误信息
id 如果如果正确,返回所上传的模型ID
name 模型名称
introduce 模型描述
priviledge 模型权限(0=公开1=私有2=对此模型用户关注的人公开)
icon 模型缩略图
uploadTime 模型上传时间
status 模型状态(0=成功1=失败 -1=处理中)
htmlAddr 模型外链地址

ret返回码说明

ret = 0: 正确返回
ret > 0: 调用OpenAPI时发生错误,需要开发者进行相应的处理。
错误码 含义说明
0 正确返回
3 缺少参数或者参数类型不对
1010 请求超时出现异常
1001 APPKEY错误
1006 权限不足或模型不存在

正确返回示例

{
    "ret":0,
    "privilege":"对所有人公开",
    "name":"自动门",
    "htmlAddr":"<iframe src='http://www.lao3d.com/model_link.html?modelid=4417'></iframe>",
    "introduce":"",
    "status":"成功",
    "uploadTime":"2013-09-23 18:32:31",
    "icon":"http://42.121.131.199/model/408_1367060685396.0.9901258249492455/okm/Thumbnail.png"
}

错误返回示例

{
    "ret":3,
    "msg":"参数错误"
}