获取场景列表
优质
小牛编辑
137浏览
2023-12-01
接口说明
开发者可以通过该接口来获取所有的场景，更好的去管理相对应的场景
如需调用，请访问 开发者文档 来查看详细的接口使用说明
该接口仅开放给已获取SDK的开发者
API地址
POST /api/scene/1.0.0/get
是否需要登录
是
请求字段说明
| 参数 | 类型 | 请求类型 | 是否必须 | 说明 |
|---|---|---|---|---|
| pageNo | int | form | 是 | 页码 |
| pageSize | int | form | 是 | 每一页展示的条数 |
| power | int | form | 否 | 场景权限,1公开；2私有 |
响应字段说明
| 参数 | 类型 | 说明 |
|---|---|---|
| guid | String | 场景唯一标识 |
| coverImg | String | 缩略图 |
| title | String | 标题 |
| descript | String | 描述 |
| baseMap | String | 底图 |
| authorGuid | String | 创建者 |
| keyword | String | 标签 |
| addTime | String | 创建时间 |
| viewTimes | String | 预览次数 |
| viewpointGuid | String | 默认视角 |
| isDel | String | 是否删除 |
| terrain | String | 地形 |
| scenepower | String | 数据权限，1公开；2私有 |
| watermarke | String | LOGO |
| username | String | 用户名 |
| photo | String | 头像 |
| powers | String | 权限 |
响应成功示例
{
"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状态码 | 原因 |
|---|---|
| 204 | No Content |
| 401 | Unauthorized |
| 403 | Forbidden |
| 40001 | 查询结果为空 |
| 40001 | 查询结果不是JSON数据 |
| 40001 | 查询结果JSON不符合要求 |
| 40002 | 请求接口失败 |
| 40003 | 参数无效 |
| 40004 | 令牌无效 |
| 40004 | 令牌为空 |
| 40005 | 无权限查看，场景为私有场景，请使用私有场景的接口 |
示例代码
$.ajax({
url:'/api/scene/1.0.0/get',
type:'POST',
data:'pageNo=&pageSize=&power=',
dataType:'text',
cache:false,
contentType: "application/x-www-form-urlencoded",
xhrFields: {
withCredentials: true
},
crossDomain: true,
success:function(data){
// 成功返回值
},
error:function(XMLHttpRequest, textStatus, errorThrown){
}
})