API reference - Ricoh Theta

/osc/info response

	Definitions
Type	`object`

Example:

{
    "manufacturer": "Ricoh Company, Ltd.",
    "model": "RICOH THETA X",
    "serialNumber": "15104645",
    "_wlanMacAddress": "58:38:79:03:39:C9",
    "_bluetoothMacAddress": "58:38:79:78:A2:35",
    "firmwareVersion": "2.40.0",
    "supportUrl": "https://theta360.com/en/support/",
    "gps": true,
    "gyro": true,
    "uptime": 847,
    "api": [
        "/osc/info",
        "/osc/state",
        "/osc/checkForUpdates",
        "/osc/commands/execute",
        "/osc/commands/status"
    ],
    "endpoints": {
        "httpPort": 80,
        "httpUpdatesPort": 80
    },
    "apiLevel": [
        2
    ]
}

Property	Type	Required	Description
api	array of string	yes	List of supported APIs
apiLevel	array of enum (of integer)	yes	List of supported API versions. This value is used only for older models than Theta X and Z1
_bluetoothMacAddress	string	yes	MAC address of Bluetooth
endpoints	object	yes	Endpoint information
firmwareVersion	string	yes	Current firmware version
gps	boolean	yes	Presence of GPS
gyro	boolean	yes	Presence of gyroscope
manufacturer	string	yes	The Theta Manufacturer name
model	string	yes	The Theta model name
serialNumber	string	yes	Serial number
supportUrl	string	yes	URL of the Theta support web page
uptime	integer	yes	Elapsed time after startup (seconds)
_wlanMacAddress	string	yes	MAC address of wireless LAN

api

	Definitions
Type	`array of string`

Description: List of supported APIs

	Array restrictions
Min items	N/A
Max items	N/A

Each item of this array must be	Description
api items	API such as “/osc/info”

api items

	Definitions
Type	`string`

Description: API such as “/osc/info”

apiLevel

	Definitions
Type	`array of enum (of integer)`

Description: List of supported API versions. This value is used only for older models than Theta X and Z1

	Array restrictions
Min items	N/A
Max items	N/A

Each item of this array must be	Description
apiLevel items	Disregard this value

apiLevel items

	Definitions
Type	`enum (of integer)`

Description: Disregard this value

Must be one of:

_bluetoothMacAddress

	Definitions
Type	`string`

Description: MAC address of Bluetooth

endpoints

	Definitions
Type	`object`

Description: Endpoint information

Property	Type	Required	Description
httpPort	integer	no	Port number for using APIs
httpUpdatesPort	integer	no	Port number for status update check (/osc/checkForUpdates API)

httpPort

	Definitions
Type	`integer`

Description: Port number for using APIs

httpUpdatesPort

	Definitions
Type	`integer`

Description: Port number for status update check (/osc/checkForUpdates API)

firmwareVersion

	Definitions
Type	`string`

Description: Current firmware version

gps

	Definitions
Type	`boolean`

Description: Presence of GPS

gyro

	Definitions
Type	`boolean`

Description: Presence of gyroscope

manufacturer

	Definitions
Type	`string`

Description: The Theta Manufacturer name

model

	Definitions
Type	`string`

Description: The Theta model name

serialNumber

	Definitions
Type	`string`

Description: Serial number

supportUrl

	Definitions
Type	`string`

Description: URL of the Theta support web page

uptime

	Definitions
Type	`integer`

Description: Elapsed time after startup (seconds)

	Restrictions
Minimum	≥ 0

_wlanMacAddress

	Definitions
Type	`string`

Description: MAC address of wireless LAN