## Obtain OBJ File
### Basic Information
**Path:** /scene/getSceneObj
**Method:** POST
**Interface Description:**
### Request Parameters
**Headers**
| Parameter Name | Parameter Value | Required or not | Example | Remarks |
| ------------ | ------------ | ------------ | ------------ | ------------ |
| Content-Type | application/json | Yes | | |
| Authorization | | Yes | | appkey |
**Body**
| Name | Type | Required or not | Default Value | Remarks | Other Information |
| sceneCode | string | Required | | Scene Code | |
### ReturnData
| Name | Type | Required or not | Default Value | Remarks | Other Information |
| code | number | Optional | | | |
| message | string | Optional | | | |
| data | string [] | Optional | | | Item Type: string |
| ├─ | | Optional | | Download Link | |
| success | boolean | Optional | | | |
| timestamp | number | Optional | | | |
## Get Panorama Image
### Basic Information
**Path:** /scene/getScenePanorama
**Method:** POST
**Interface Description:**
### Request Parameters
**Headers**
| Parameter Name | Parameter Value | Required or not | Example | Remarks |
| ------------ | ------------ | ------------ | ------------ | ------------ |
| Content-Type | application/json | Yes | | |
| Authorization | | Yes | | appkey |
**Body**
| Name | Type | Required or not | Default Value | Remarks | Other Information |
| sceneCode | string | Required | | Scene Code | |
### ReturnData
| Name | Type | Required or not | Default Value | Remarks | Other Information |
| code | number | Optional | | | |
| message | string | Optional | | | |
| data | string [] | Optional | | | item Type: string |
| ├─ | | Optional | | Download Link | |
| success | boolean | Optional | | | |
| timestamp | number | Optional | | | |
## Obtain Scene List
### Basic Information
**Path:** /scene/getSceneList
**Method:** POST
**Interface Description:**
### Request Parameters
**Headers**
| Parameter Name | Parameter Value | Required or not | Example | Remarks |
| ------------ | ------------ | ------------ | ------------ | ------------ |
| Content-Type | application/json | Yes | | |
| Authorization | | Yes | | User appkey |
**Body**
| Name | Type | Required or not | Default Value | Remarks | Other Information |
| cameraType | string | Optional | | Camera Type(mega-激光,kankan-看看、看见),Not specified, default to all | |
| pageNum | number | Optional | | Page Number | |
| pageSize | number | Optional | | Page Size | |
### ReturnData
| Name | Type | Required or not | Default Value | Remarks | Other Information |
| code | number | Optional | | Request Response Code (0-Success) | |
| message | string | Optional | | | |
| data | object | Optional | | | |
| ├─ pageNum | number | Optional | | Page Number | |
| ├─ pageSize | number | Optional | | Page Size | |
| ├─ total | number | Optional | | Total | |
| ├─ list | object [] | Optional | | Current Page Data | item Type: object |
| ├─ userName | null | Optional | | Username | |
| ├─ cameraType | string | Optional | | Camera Type | |
| ├─ sceneCode | string | Optional | | Scene Code | |
| ├─ sceneName | string | Optional | | Scene Name | |
| ├─ createTime | string | Optional | | Creation Time | |
| ├─ shootCount | number | Optional | | Number of Points | |
| ├─ snCode | string | Optional | | Camera SN | |
| success | boolean | Optional | | | |
| timestamp | number | Optional | | | |
## Obtain Scene Point Information
### Basic Information
**Path:** /scene/getScenePointInfo
**Method:** POST
**Interface Description:**
### Request Parameters
**Headers**
| Parameter Name | Parameter Value | Required or not | Example | Remarks |
| ------------ | ------------ | ------------ | ------------ | ------------ |
| Content-Type | application/json | Yes | | |
| Authorization | | Yes | | appkey |
**Body**
| Name | Type | Required or not | Default Value | Remarks | Other Information |
| sceneCode | string | Required | | Scene Code | |
### ReturnData
```javascript
PRO | MINION Scene Example:
{
"code":0,
"message":"Success",
"data":[
{
"subgroup":0,
"subdevice":0,
"pose":{
"rotation":{
"w":0.0056687597393,
"x":0.0041020903986,
"y":-0.0006555021159,
"z":0.9999753038622
},
"translation":{
"x":0.2480049928576,
"y":-0.1253160400283,
"z":0.0698075
}
},
"visibles3":[
1,
2
],
"visibles2":[
1,
2
],
"puck":{
"x":0.2480049928576,
"y":-0.1253160400283,
"z":-0.8756464839194
},
"id":0,
"uuid":"0",
"device":0,
"visibles":[
1,
2
],
"room":0,
"group":1
},
{
"subgroup":0,
"subdevice":0,
"pose":{
"rotation":{
"w":0.488034808399,
"x":0.003275388833,
"y":-0.0025556977961,
"z":0.8728142792299
},
"translation":{
"x":0.5115810031314,
"y":0.0985001423026,
"z":0.0670305
}
},
"visibles3":[
0,
2
],
"visibles2":[
0,
2
],
"puck":{
"x":0.5115810031314,
"y":0.0985001423026,
"z":-0.8784234839194
},
"id":1,
"uuid":"4",
"device":2,
"visibles":[
0,
2
],
"room":0,
"group":1
},
{
"subgroup":0,
"subdevice":0,
"pose":{
"rotation":{
"w":-0.2091556113663,
"x":0.0041477093186,
"y":0.0002411830965,
"z":0.9778735442644
},
"translation":{
"x":-0.5107311412508,
"y":0.1257464444695,
"z":0.0829645
}
},
"visibles3":[
0,
1
],
"visibles2":[
0,
1
],
"puck":{
"x":-0.5107311412508,
"y":0.1257464444695,
"z":-0.8624894839194
},
"id":2,
"uuid":"8",
"device":4,
"visibles":[
0,
1
],
"room":0,
"group":1
}
],
"success":true,
"timestamp":1679910791171
}
MEGA Scene Example:
{
"code":0,
"message":"Success",
"data":{
"point":[
{
"datasetLocation":[
0,
0,
0
],
"datasetFloorLocation":[
0,
0,
-1.229380953505
],
"location":[
113.59572587333702,
22.366579193007002,
0
],
"id":"1630115697503375360",
"datasetOrientation":[
0.1098153948208,
0.0053919050116,
-0.0093916045299,
0.9938930043949
],
"fileId":"00000"
}
]
},
"success":true,
"timestamp":1679910917030
}
```
## Obtain Scene Editing Data
### Basic Information
**Path:** /scene/getSceneViewUserFile
**Method:** POST
**Interface Description:**
### Request Parameters
**Headers**
| Parameter Name | Parameter Value | Required or not | Example | Remarks |
| ------------ | ------------ | ------------ | ------------ | ------------ |
| Content-Type | application/json | Yes | | |
| Authorization | String | Yes | asdasdasdasd | appkey |
**Body**
| Name | Type | Required or not | Default Value | Remarks | Other Information |
| sceneCode | string | Required | | Scene Code | |
### ReturnData
| Name | Type | Required or not | Default Value | Remarks | Other Information |
| code | number | Optional | | | |
| message | string | Optional | | | |
| data | string | Optional | | Zip Package Link | |
| success | boolean | Optional | | | |
| timestamp | number | Optional | | | |
## Scene Image Annotation Data Save and Modify
### Basic Information
**Path:** /scene/sceneMarkShape/saveOrEdit
**Method:** POST
**Interface Description:**
### Request Parameters
**Headers**
| Parameter Name | Parameter Value | Required or not | Example | Remarks |
| ------------ | ------------ | ------------ | ------------ | ------------ |
| Content-Type | application/json | Yes | | |
| Authorization | | Yes | | appkey |
**Body**
| Name | Type | Required or not | Default Value | Remarks | Other Information |
| version | string | Required | | | |
| shapes | object [] | Required | | | item Type: object |
| ├─ score | number | Required | | Score Value | |
| ├─ color | number [] | Required | | rgbColor | item Type: number |
| ├─ | | Optional | | | |
| ├─ bbox | number [] | Required | | Annotation Box 4-Point Data xyxy | item Type: number |
| ├─ | | Optional | | | |
| ├─ label | string | Required | | xywh Data | |
| ├─ category | string | Required | | Category Name | |
| imagePath | string | Required | | 图片Name路径 | |
| imageHeight | number | Required | | Height | |
| imageWidth | number | Required | | Width | |
| num | string | Required | | Scene Code | |
| id | number | Optional | | Save as Empty, Modify with ID Data | |
### ReturnData
| Name | Type | Required or not | Default Value | Remarks | Other Information |
| code | number | Optional | | 0 for success | |
| message | string | Optional | | | |
| data | boolean | Optional | | | |
| success | boolean | Optional | | | |
| timestamp | number | Optional | | | |
## Obtain Scene Spherical View Data
### Basic Information
**Path:** /scene/getSceneVideo
**Method:** POST
**Interface Description:**
This interface takes longer to process, limit 60 seconds per request
### Request Parameters
**Headers**
| Parameter Name | Parameter Value | Required or not | Example | Remarks |
| ------------ | ------------ | ------------ | ------------ | ------------ |
| Content-Type | application/json | Yes | | |
| Authorization | String | Yes | asdasdasdasd | appkey |
**Body**
| Name | Type | Required or not | Default Value | Remarks | Other Information |
| sceneCode | string | Required | | Scene Code | |
### ReturnData
| Name | Type | Required or not | Default Value | Remarks | Other Information |
| code | number | Optional | | | |
| message | string | Optional | | | |
| data | string | Optional | | Zip Package Link | |
| success | boolean | Optional | | | |
| timestamp | number | Optional | | | |
## Obtain Scene Point Cloud and Depth Map
### Basic Information
**Path:** /scene/getSceneRaw
**Method:** POST
**Interface Description:**
### Request Parameters
**Headers**
| Parameter Name | Parameter Value | Required or not | Example | Remarks |
| ------------ | ------------ | ------------ | ------------ | ------------ |
| Content-Type | application/json | Yes | | |
| Authorization | | Yes | | 用户appkey |
**Body**
| Name | Type | Required or not | Default Value | Remarks | Other Information |
| sceneCode | string | Required | | Scene Code | |
### ReturnData
| Name | Type | Required or not | Default Value | Remarks | Other Information |
| code | number | Optional | | | |
| message | string | Optional | | | |
| data | object [] | Optional | | | item Type: object |
| ├─ fileName | string | Required | | Filename | |
| ├─ url | string | Required | | Download path | |
| success | boolean | Optional | | | |
| timestamp | number | Optional | | | |
## Get Login Token
### Basic Information
**Path:** /user/v1/login
**Method:** POST
**Interface Description:**
### Request Parameters
**Headers**
| Parameter Name | Parameter Value | Required | Example | Note |
| ------------ | ------------ | ------------ | ------------ | ------------ |
| Content-Type | application/json | yes | | |
| Authorization | | yes | | appkey |
**Body**
| Name | Type | Required | Default Value | Note | Other Information |
| userName | string | Required | | Username | |
| password | string | Required | | Password(Plaintext) | |
### Response Data
| Name | Type | Required | Default Value | Note | Other Information |
| code | number | Optional | | | |
| message | string | Optional | | | |
| data | string | Optional | | token | |
| success | boolean | Optional | | | |
| timestamp | number | Optional | | | |
## Get the room list with the token obtained from the official website
### Basic Information
**Path:** /takelook/roomList
**Method:** POST
**Interface Description:**
### Request Parameters
**Headers**
| Parameter Name | Parameter Value | Mandatory | Example | Remarks |
| ------------ | ------------ | ------------ | ------------ |-------------------------|
| Content-Type | application/json | yes | | |
| Authorization | | yes | | appkey |
| fd-takelook-token | | yes | | /user/v1/login token obtained in Login |
**Body**
| Name | Type | Mandatory | Default Value | Remarks | Other Information |
| pageNum | string | required | | current page | |
| pageSize | string | required | | page number | |
### Return Data
| Name | Type | Mandatory | Default Value | Remarks | Other Information |
| code | number | optional | | | |
| message | string | optional | | | |
| data | object | optional | | | |
| ├─ pageNum | number | optional | | | |
| ├─ pageSize | number | optional | | | |
| ├─ total | number | optional | | | |
| ├─ list | object [] | optional | | | item Type: object |
| ├─ roomId | string | required | | Room ID | |
| ├─ roomTitle | string | required | | Room Title | |
| ├─ roomInfo | string | required | | Room Description | |
| ├─ roomHostName | string | required | | Room Host Nickname | |
| ├─ roomUserName | string | required | | Room Host Username | |
| ├─ roomCoverUrl | string | required | | Room Cover Image | |
| ├─ roomShareCode | null,string | required | | Room Share QR Code | |
| ├─ roomHostCode | null,string | required | | Room Host QR Code | |
| ├─ roomShareUrl | null | required | | Room Share Link | |
| ├─ tbStatus | number | required | | | |
| ├─ createTime | string | required | | | |
| ├─ updateTime | string | required | | | |
| ├─ roomStatus | number | required | | Room Status (0: Not Open, 1: In Progress, 2: Closed) | |
| ├─ lastLookTime | null,string | required | | | |
| ├─ isShow | number | required | | Room status, 0 : hidden, 1 : displayed | |
| ├─ useStartTime | string | required | | Use Start Time | |
| ├─ useEndTime | string | required | | Use End Time | |
| ├─ visitPassword | null | required | | Room Password | |
| ├─ takeLookLock | number | required | | Viewing Lock (0: No Password, 1: Password Protected | |
| ├─ freeRoamLock | number | required | | Free Roaming Lock (0: No Password, 1: Password Protected) | |
| ├─ maxMan | number | required | | Maximum Number of Room Participants | |
| ├─ hostStatus | number | required | | Host Status (0: Not Entered Room, 1: Entered Room) | |
| ├─ head | string,null | required | | Avatar | |
| ├─ gps | null | required | | Scene GPS | |
| ├─ platform | string | required | | | |
| ├─ image | string [] | required | | Image | item Type: string |
| ├─ | | optional | | | |
| ├─ video | string [] | required | | video | item Type: string |
| ├─ | | optional | | | |
| ├─ roomUserId | null | required | | | |
| ├─ roomViewCount | number | required | | Room Access Count | |
| ├─ useTimeList | string [] | required | | | item Type: string |
| ├─ | | optional | | | |
| success | boolean | optional | | | |
| timestamp | number | optional | | | |