根据ID获取场景(公开场景)

优质
小牛编辑
123浏览
2023-12-01

接口说明

场景分公开私有,私有的场景只能自己查看或者团队,公开的场景可以对所有人查看,包括游客(没有登录的用户),此接口是为了分享场景给其他人查看,无需进行登录操作就可以查看到场景的相关信息
如需调用,请访问 开发者文档 来查看详细的接口使用说明
该接口仅开放给已获取SDK的开发者

API地址

POST /api/scene/1.0.0/getPublic

是否需要登录

请求字段说明

参数类型请求类型是否必须说明
idstringform场景ID

响应字段说明

参数类型说明
guidString场景唯一标识
coverImgString缩略图
titleString标题
descriptString描述
baseMapString底图
authorGuidString创建者
keywordString标签
addTimeString创建时间
viewTimesString预览次数
viewpointGuidString默认视角
isDelString是否删除
terrainString地形
scenepowerString数据权限,1公开;2私有
watermarkeStringLOGO
usernameString用户名
photoString头像
powersString权限

响应成功示例

{
  "code": 200,
  "data": {
    "coverImg": "data/image/76e29616-3312-4b25-bcc6-5d20483a6b1f.jpg",
    "addTime": "1534473349000",
    "watermarke": "data/image/76e29616-3312-4b25-bcc6-5d20483a6b1f.jpg",
    "guid": "7bbf39cd-41e0-42cc-a324-8956cdcda59a",
    "authorGuid": "0829b03d-4458-87c0-e67671a8291a",
    "scenepower": "2",
    "title": "我的场景",
    "descript": "这是场景描述",
    "keyword": "实景三维,标签",
    "viewTimes": 7,
    "isDel": 0,
    "viewpointGuid": "0829b03d-4458-87c0-e67671a8291a"
  },
  "message": "OK"
}

响应失败示例

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

响应接受类型

application/json:charset=utf-8

响应状态码

HTTP状态码原因
204No Content
401Unauthorized
403Forbidden
40001查询结果为空
40001查询结果不是JSON数据
40001查询结果JSON不符合要求
40002请求接口失败
40003参数无效
40004令牌无效
40004令牌为空
40005接口使用错误,场景为私有场景,请使用私有场景的接口

示例代码

$.ajax({
    url:'/api/scene/1.0.0/getPublic',
    type:'POST',
    data:'id=',
    dataType:'text',
    cache:false,
    contentType: "application/x-www-form-urlencoded",
	xhrFields: {
        withCredentials: true
    },
    crossDomain: true,
    success:function(data){
        // 成功返回值
    },
    error:function(XMLHttpRequest, textStatus, errorThrown){

    }
})