添加视角
优质
小牛编辑
132浏览
2023-12-01
接口说明
添加视角
如需调用，请访问 开发者文档 来查看详细的接口使用说明
该接口仅开放给已获取SDK的开发者
API地址
POST /api/viewpoint/1.0.0/add
是否需要登录
是
请求字段说明
| 参数 | 类型 | 请求类型 | 是否必须 | 说明 |
|---|---|---|---|---|
| dId | string | form | 是 | 场景ID |
| name | string | form | 是 | 视角名称 |
| directionx | number | form | 是 | 相机位置，从camera.direction中获取 |
| directiony | number | form | 是 | 相机位置，从camera.direction中获取 |
| directionz | number | form | 是 | 相机位置，从camera.direction中获取 |
| posx | number | form | 是 | 相机位置，从camera.position中获取 |
| posy | number | form | 是 | 相机位置，从camera.position中获取 |
| posz | number | form | 是 | 相机位置，从camera.position中获取 |
| upx | number | form | 是 | 相机位置，从camera.up中获取 |
| upy | number | form | 是 | 相机位置，从camera.up中获取 |
| upz | number | form | 是 | 相机位置，从camera.up中获取 |
| time | number | form | 是 | 飞行时间 |
响应字段说明
无
响应成功示例
{
"code": 200,
"data": "视角的唯一标识",
"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 | 令牌为空 |
示例代码
$.ajax({
url:'/api/viewpoint/1.0.0/add',
type:'POST',
data:'posx=&posy=&posz=&name=&directionx=&directiony=&directionz=&time=&upx=&dId=&upz=&upy=',
dataType:'text',
cache:false,
contentType: "application/x-www-form-urlencoded",
xhrFields: {
withCredentials: true
},
crossDomain: true,
success:function(data){
// 成功返回值
},
error:function(XMLHttpRequest, textStatus, errorThrown){
}
})