{"info":{"_postman_id":"f9d26352-37a9-48d8-8525-f3a4021a15a2","name":"Bhaskar's Home - Smart Devices","description":"

Bhaskar's Home Smart Devices APIs provide a comprehensive interface for integrating and controlling various smart devices in a modern home environment. These APIs offer seamless connectivity and control over devices such as smart thermostats, lighting systems, security cameras, and home entertainment units.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"15482145","collectionId":"f9d26352-37a9-48d8-8525-f3a4021a15a2","publishedId":"TzXtK1Pu","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303045","highlight":"EF5B55"},"publishDate":"2021-05-23T10:46:59.000Z"},"item":[{"name":"Cameras","item":[{"name":"Cameras for a location","id":"9e58400a-f704-405e-8258-f4b6a4b79354","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"apiKey"},{"key":"value","value":""}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.bhaskar.com/v2/devices/cameras?apiKey&locationId=123123123","description":"

Cameras Endpoint

Use this endpoint to retrieve the data for all the cameras in a given location.

Retrieve camera data

To retrieve the cameras data, include your apikey and intended locationId as query parameters.

Method: GET

Endpoint: https://api.bhaskar.com/v2/devices/cameras

Response body:

[\n  {\n    \"model\": \"C1\",\n    \"serial\": \"1909ZB39822\",\n    \"maxResolution\": \"1280x720\",\n    \"firmwareVer\": \"v1.89_20210506\",\n    \"deviceClass\": \"Camera\",\n    \"deviceType\": \"C1\",\n    \"deviceID\": \"33795f78-f531-2f45-bd5c-321gg73f34fr\",\n    \"userDefinedDeviceName\": \"frontCamera\",\n    \"isAlive\": true,\n    \"isUpgrading\": false,\n    \"isProvisioned\": true,\n    \"macID\": \"34FA38C8932\"\n  }\n]\n\n

Cameras_Parameters

Cameras Request Query_Parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Description	Required
apikey	Your API Key	Required
locationId	Location ID for which cameras data should be retrieved	Required

Cameras Response body_parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Element	Type	Description
model	String	Model of the camera
serial	String	Serial Number of the camera
maxResolution	String	Max recording/display resolution of the camera (e.g., \"1280x720\")
firmwareVer	String	Cameras Current running firmware version
deviceClass	String	Class of the device (e.g., \"Camera\", \"Thermostat\")
deviceType	String	Type of the device
deviceID	String	Unique ID of the device
userDefinedDeviceName	String	User defined name of the device
isAlive	Boolean	Shows if the Camera is currently online. True = currently online
isUpgrading	Boolean	Shows if the Camera is currently upgrading firmware. True = currently upgrading
isProvisioned	Boolean	Shows if the Camera is currently provisioned correctly. True/false
macID	String	MacID of the device

Cameras Status Codes

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Code	Description	API Specific description
200	OK	JSON object with camera data for a location
400	BAD REQUEST	The browser (or proxy) sent a request that this server could not understand.
401	UNAUTHORIZED	Authorization has been denied for this request

","urlObject":{"path":["cameras"],"host":["https://api.bhaskar.com/v2/devices"],"query":[{"key":"apiKey","value":null},{"description":{"content":"

(Required) Location ID of the Camera

\n","type":"text/plain"},"key":"locationId","value":"123123123"}],"variable":[]}},"response":[{"id":"efe70591-76ef-4073-b1db-b7464eb3b555","name":"OK","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.bhaskar.com/v2/devices/cameras?locationId=12312&apiKey=","protocol":"https","host":["api","bhaskar","com"],"path":["v2","devices","cameras"],"query":[{"key":"locationId","value":"12312"},{"key":"apiKey","value":""}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"model\": \"C1\",\n \"serial\": \"1909ZB39822\",\n \"maxResolution\": \"1280x720\",\n \"firmwareVer\": \"v1.89_20210506\",\n \"deviceClass\": \"Camera\",\n \"deviceType\": \"C1\",\n \"deviceID\": \"33795f78-f531-2f45-bd5c-321gg73f34fr\",\n \"userDefinedDeviceName\": \"frontCamera\",\n \"isAlive\": false,\n \"isUpgrading\": false,\n \"isProvisioned\": true,\n \"macID\": \"34FA38C8932\"\n },\n {\n \"model\": \"C1\",\n \"serial\": \"1909ZB39822\",\n \"maxResolution\": \"1280x720\",\n \"firmwareVer\": \"v1.89_20210506\",\n \"deviceClass\": \"Camera\",\n \"deviceType\": \"C1\",\n \"deviceID\": \"33795f78-f531-2f45-bd5c-321gg73f34fr\",\n \"userDefinedDeviceName\": \"frontCamera\",\n \"isAlive\": false,\n \"isUpgrading\": false,\n \"isProvisioned\": true,\n \"macID\": \"34FA38C8932\"\n }\n]"},{"id":"c9ffdb86-0f47-4208-8b99-d73a12392dc5","name":"The browser (or proxy) sent a request that this server could not understand.","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.bhaskar.com/v2/devices/cameras?locationId=example&apiKey=","host":["https://api.bhaskar.com/v2/devices"],"path":["cameras"],"query":[{"key":"locationId","value":"example"},{"key":"apiKey","value":""}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": \"Bad Request\",\n \"message\": \"Invalid URL\"\n}"},{"id":"e14cf405-2558-476c-8877-eca2cce3094a","name":"Unauthorized","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.bhaskar.com/v2/devices/cameras?locationId=example&apiKey=","host":["https://api.bhaskar.com/v2/devices"],"path":["cameras"],"query":[{"key":"locationId","value":"example"},{"key":"apiKey","value":""}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": \"Unauthorized\",\n \"message\": \"Authorization has been denied for this request\"\n}"}],"_postman_id":"9e58400a-f704-405e-8258-f4b6a4b79354"},{"name":"Change Camera Configuration","id":"0312195c-fa40-4dc2-97ca-4b95935e8d9b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"apiKey"},{"key":"value","value":""}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"version\": \"1.0\",\n \"deviceId\": \"07182FC1FC35D69780DEE2E889E15BEBC1814624F260B04759827DBBD6E2EB6A\",\n \"audioDetection\": \"on\",\n \"audioSensitivity\": 33,\n \"micStatus\": \"on\",\n \"speakerStatus\": \"on\",\n \"motionDetection\": \"on\",\n \"motionArea\": [\n {\n \"startX\": 0,\n \"startY\": 0,\n \"width\": 699,\n \"height\": 414,\n \"sensitivity\": 99\n },\n {\n \"startX\": 37,\n \"startY\": 487,\n \"width\": 206,\n \"height\": 214,\n \"sensitivity\": 99\n }\n ],\n \"nightMode\": \"auto\",\n \"ledStatus\": \"on\",\n \"storagePlan\": \"day\",\n \"motionZone\": \"rectangle\",\n \"privacyMode\": \"off\",\n \"geoFence\": \"on\"\n}"},"url":"https://api.bhaskar.com/v2/devices/cameras/:deviceId/config?locationId=Example","description":"

Camera Config Endpoint

Use the camera config endpoint to Change the configuration of a specific camera within a location.

Note: The entire configuration request object for a camera must be sent every time, including the unchanged values.

To change config

To change the configuration of a specific camera, include your apikey and intended locationId as query parameters.

Method: POST

Endpoint: https://api.bhaskar.com/v2/devices/Cameras/{deviceId}/Config

Request body:

{\n  \"version\": \"string\",\n  \"deviceId\": \"string\",\n  \"audioDetection\": \"string\",\n  \"audioSensitivity\": 0,\n  \"micStatus\": \"string\",\n  \"speakerStatus\": \"string\",\n  \"motionDetection\": \"string\",\n  \"motionArea\": [\n    {\n      \"startX\": 0,\n      \"startY\": 0,\n      \"width\": 10,\n      \"height\": 10,\n      \"sensitivity\": 33\n    },\n   {\n      \"startX\": 45,\n      \"startY\": 485,\n      \"width\": 15,\n      \"height\": 15,\n      \"sensitivity\": 99\n    }\n  ],\n  \"nightMode\": \"string\",\n  \"ledStatus\": \"string\",\n  \"storagePlan\": \"string\",\n  \"motionZone\": \"string\",\n  \"privacyMode\": \"string\",\n  \"geoFence\": \"string\"\n}\n\n

Camera Config_Parameters

Config Request Path_parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Description	Required
{deviceId}	Device ID of the camera to change the configuration	Required

Config Request Query_parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Description	Required
apikey	Your API Key	Required
locationId	Location ID for which cameras data should be retrieved	Required

Config Request Body_parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Element		Type	Description	Required
version		String	Version of the camera device	Required
deviceId		String	Device ID of the camera	Required
audioDetection		String	Camera's Audio detection on/off	Required
audioSenstivity		Integer	Camera's current audio sensitivity setting: 0-100	Required
micStatus		String	Camera's Microphone on/off	Required
speakerStatus		String	Camera's Speaker on/off	Required
motionDetection		String	Camera's Motion detection on/off	Required
motionArea		Array	Array defining Camera's all motion detection areas	Required
	motionArea.startX	Integer	Camera's Starting X resolution position of the area	Required
	motionArea.startY	Integer	Camera's Starting Y resolution position of the area	Required
	motionArea.width	Integer	Width of the Camera's detection area	Required
	motionArea.height	Integer	Height of the Camera's detection area	Required
	motionArea.sensitivity	Integer	Sensitivity level of Camera's motion detection for the area. Higher the value, greater the sensitivity. (0, 33, 66, 99)	Required
nightMode		String	Camera's Night vision mode toggle	Required
ledStatus		String	State of the Camera's front LED	Required
storagePlan		String	Camera's Video clip storage plan	Required
motionZone		String	Shape of the Camera's motion detection zone	Required
privacyMode		String	Camera's Privacy mode state	Required
geoFence		String	Geofencing state. Typically, this results in camera being OFF when home and ON when away.	Required

Config Status Codes

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Code	Description	API Specific description
200	OK	JSON object with success message
400	BAD REQUEST	The browser (or proxy) sent a request that this server could not understand.
401	UNAUTHORIZED	Authorization has been denied for this request
403	FORBIDDEN	Duplicate request

","urlObject":{"path":["cameras",":deviceId","config"],"host":["https://api.bhaskar.com/v2/devices"],"query":[{"description":{"content":"

(Required) Location ID of the Camera

\n","type":"text/plain"},"key":"locationId","value":"Example"}],"variable":[{"description":{"content":"

(Required) ID of the camera to change the configuration.

\n","type":"text/plain"},"type":"any","value":"123123123","key":"deviceId"}]}},"response":[{"id":"987cd037-dd75-4f85-a85e-08e54ce34c4f","name":"OK","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"version\": \"1.0\",\n \"deviceId\": \"07182FC1FC35D69780DEE2E889E15BEBC1814624F260B04759827DBBD6E2EB6A\",\n \"audioDetection\": \"on\",\n \"audioSensitivity\": 33,\n \"micStatus\": \"on\",\n \"speakerStatus\": \"on\",\n \"motionDetection\": \"on\",\n \"motionArea\": [\n {\n \"startX\": 0,\n \"startY\": 0,\n \"width\": 699,\n \"height\": 414,\n \"sensitivity\": 99\n },\n {\n \"startX\": 37,\n \"startY\": 487,\n \"width\": 206,\n \"height\": 214,\n \"sensitivity\": 99\n }\n ],\n \"nightMode\": \"auto\",\n \"ledStatus\": \"on\",\n \"storagePlan\": \"day\",\n \"motionZone\": \"rectangle\",\n \"privacyMode\": \"off\",\n \"geoFence\": \"on\"\n}"},"url":{"raw":"https://api.bhaskar.com/v2/devices/cameras/:deviceId/config?locationId=1242&apiKey=","protocol":"https","host":["api","bhaskar","com"],"path":["v2","devices","cameras",":deviceId","config"],"query":[{"key":"locationId","value":"1242"},{"key":"apiKey","value":""}],"variable":[{"key":"deviceId"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": \"OK\",\n \"message\": \"Camera Configuration Updated!\"\n}"},{"id":"0a67a7ac-f3a4-438d-852d-2d02547adbae","name":"The browser (or proxy) sent a request that this server could not understand.","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"version\": \"Ut magna sit officia dolore\",\n \"deviceId\": \"est in ea velit\",\n \"audioDetection\": \"in cupidatat dolore\",\n \"audioSensitivity\": -72356782,\n \"micStatus\": \"magna proident dolor culpa\",\n \"speakerStatus\": \"magna velit pariatur\",\n \"motionDetection\": \"pariatur officia\",\n \"motionArea\": [\n {\n \"startX\": 24827738,\n \"startY\": 55881096,\n \"width\": 57426362,\n \"height\": -88312129,\n \"sensitivity\": -39226321\n },\n {\n \"startX\": -58372786,\n \"startY\": -13384432,\n \"width\": -76752490,\n \"height\": -51116002,\n \"sensitivity\": 64333061\n }\n ],\n \"nightMode\": \"eu sed Duis do\",\n \"ledStatus\": \"tempor Ut\",\n \"storagePlan\": \"in cillum\",\n \"motionZone\": \"o\",\n \"privacyMode\": \"dolor Duis quis anim\",\n \"geoFence\": \"anim amet fugiat\"\n}"},"url":{"raw":"https://api.bhaskar.com/v2/devices/cameras/:deviceId/config?locationId=example&apiKey=","host":["https://api.bhaskar.com/v2/devices"],"path":["cameras",":deviceId","config"],"query":[{"key":"locationId","value":"example"},{"key":"apiKey","value":""}],"variable":[{"key":"deviceId"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": \"Bad Request\",\n \"message\": \"Invalid URL\"\n}"},{"id":"ab51652f-f5a8-4c50-963c-472f3f3937b5","name":"Unauthorized","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"version\": \"Ut magna sit officia dolore\",\n \"deviceId\": \"est in ea velit\",\n \"audioDetection\": \"in cupidatat dolore\",\n \"audioSensitivity\": -72356782,\n \"micStatus\": \"magna proident dolor culpa\",\n \"speakerStatus\": \"magna velit pariatur\",\n \"motionDetection\": \"pariatur officia\",\n \"motionArea\": [\n {\n \"startX\": 24827738,\n \"startY\": 55881096,\n \"width\": 57426362,\n \"height\": -88312129,\n \"sensitivity\": -39226321\n },\n {\n \"startX\": -58372786,\n \"startY\": -13384432,\n \"width\": -76752490,\n \"height\": -51116002,\n \"sensitivity\": 64333061\n }\n ],\n \"nightMode\": \"eu sed Duis do\",\n \"ledStatus\": \"tempor Ut\",\n \"storagePlan\": \"in cillum\",\n \"motionZone\": \"o\",\n \"privacyMode\": \"dolor Duis quis anim\",\n \"geoFence\": \"anim amet fugiat\"\n}"},"url":{"raw":"https://api.bhaskar.com/v2/devices/cameras/:deviceId/config?locationId=example&apiKey=","host":["https://api.bhaskar.com/v2/devices"],"path":["cameras",":deviceId","config"],"query":[{"key":"locationId","value":"example"},{"key":"apiKey","value":""}],"variable":[{"key":"deviceId"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": \"Unauthorized\",\n \"message\": \"Authorization has been denied for this request\"\n}"},{"id":"03270623-5b29-4497-8208-ba2776ddaf7b","name":"Forbidden","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"version\": \"Ut magna sit officia dolore\",\n \"deviceId\": \"est in ea velit\",\n \"audioDetection\": \"in cupidatat dolore\",\n \"audioSensitivity\": -72356782,\n \"micStatus\": \"magna proident dolor culpa\",\n \"speakerStatus\": \"magna velit pariatur\",\n \"motionDetection\": \"pariatur officia\",\n \"motionArea\": [\n {\n \"startX\": 24827738,\n \"startY\": 55881096,\n \"width\": 57426362,\n \"height\": -88312129,\n \"sensitivity\": -39226321\n },\n {\n \"startX\": -58372786,\n \"startY\": -13384432,\n \"width\": -76752490,\n \"height\": -51116002,\n \"sensitivity\": 64333061\n }\n ],\n \"nightMode\": \"eu sed Duis do\",\n \"ledStatus\": \"tempor Ut\",\n \"storagePlan\": \"in cillum\",\n \"motionZone\": \"o\",\n \"privacyMode\": \"dolor Duis quis anim\",\n \"geoFence\": \"anim amet fugiat\"\n}"},"url":{"raw":"https://api.bhaskar.com/v2/devices/cameras/:deviceId/config?locationId=example&apiKey=","host":["https://api.bhaskar.com/v2/devices"],"path":["cameras",":deviceId","config"],"query":[{"key":"locationId","value":"example"},{"key":"apiKey","value":""}],"variable":[{"key":"deviceId"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": \"Request Forbidden\",\n \"message\": \"Duplicate request\"\n}"}],"_postman_id":"0312195c-fa40-4dc2-97ca-4b95935e8d9b"}],"id":"587a0d4a-ffb1-497d-a743-29dfadbad971","description":"

All the API calls to Bhaskar's Smart Home Camera Devices

\n","_postman_id":"587a0d4a-ffb1-497d-a743-29dfadbad971"}],"event":[{"listen":"prerequest","script":{"id":"29526d3e-1106-4ee7-b8e6-93b138cf57e3","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"fdef1c22-3e13-4125-8af9-42dbde936e48","type":"text/javascript","exec":[""]}}],"variable":[{"key":"baseUrl","value":"https://api.bhaskar.com/v2/devices"}]}