{"type":"doc","content":[{"type":"heading","attrs":{"level":2},"content":[{"text":"States","type":"text"}]},{"type":"paragraph","content":[{"text":"RapidSense is comprised of 4 states: ","type":"text"},{"text":"discovery","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"calibrating","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"operating, and fatal","type":"text","marks":[{"type":"em"}]},{"text":". The transitions are coordinated by users of the system based on what commands they issue to RapidSense. If at any point an error is encountered that requires user-intervention to resolve, RapidSense transitions into a fatal state and will not operate until the cause is resolved. The following figure illustrates the transitions.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":473,"id":"d61f10ba-8d24-41b5-824d-39fc3a22310a","collection":"contentId-3467120157","type":"file","height":419}}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Messages ","type":"text"}]},{"type":"paragraph","content":[{"text":"The following messages define the RapidSense 2.x API. ","type":"text"}]},{"type":"paragraph","content":[{"text":"For REST interface endpoints, use port number 11235. For example, ","type":"text"},{"text":"http://localhost:11235/volumes","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Volumes","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"General description","type":"text"}]},{"type":"paragraph","content":[{"text":"Users can create, read, update, and delete volumes defined in the project. This is a purely REST interface. ","type":"text"}]},{"type":"bodiedExtension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt","parameters":{"macroParams":{"name":{"value":"Volumes_REST"}},"macroMetadata":{"macroId":{"value":"947a489fbb382f7f604fc36cf422726f"},"schemaVersion":{"value":"1"},"title":"Excerpt"}},"localId":"ccb7f455-016a-440d-83a7-7cb2f07e9f18"},"content":[{"type":"table","attrs":{"layout":"default","localId":"ef696ed8-b4de-4ed1-8acb-40b124d03727"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[190.0]},"content":[{"type":"paragraph","content":[{"text":"Endpoint","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[536.0]},"content":[{"type":"codeBlock","content":[{"text":"/volumes","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[190.0]},"content":[{"type":"paragraph","content":[{"text":"Supported Operations","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[536.0]},"content":[{"type":"paragraph","content":[{"text":"GET, POST, PUT, and DELETE","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[190.0]},"content":[{"type":"paragraph","content":[{"text":"Base Endpoint","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[536.0]},"content":[{"type":"codeBlock","content":[{"text":":/volumes","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Create","type":"text"}]},{"type":"paragraph","content":[{"text":"To create a volume, users ","type":"text"},{"text":"POST","type":"text","marks":[{"type":"code"}]},{"text":" to the ","type":"text"},{"text":"/volumes","type":"text","marks":[{"type":"code"}]},{"text":" endpoint. ","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"0684d9d6-1821-4100-a0a5-e272ae92e4cc"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Operation","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"paragraph","content":[{"text":"Creates a volume.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Request","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","content":[{"text":"POST :/volumes","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Response Body Format","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"volume\": { \n \"id\": integer, \n \"bounds\": {\n \"lower\": [double, double, double], \n \"upper\": [double, double, double]\n }\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Example Response Body","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"volumes\": [\n {\n \"id\": 1,\n \"bounds\": {\n \"lower\": [-10.0, -10.0, -10.0]\n \"upper\": [10.0, 10.0, 10.0]\n }\n }\n ]\n}","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Read","type":"text"}]},{"type":"paragraph","content":[{"text":"To read a list of all volumes configured in RapidSense, users can perform a ","type":"text"},{"text":"GET","type":"text","marks":[{"type":"code"}]},{"text":" on the ","type":"text"},{"text":"/volumes","type":"text","marks":[{"type":"code"}]},{"text":" endpoint and receive a list of all volumes with their IDs and bounds.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"da50ccc4-adab-40a4-9095-f5917930f2fd"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Operation","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"paragraph","content":[{"text":"Returns a list of all configured volumes in the system.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Request","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","content":[{"text":"GET :/volumes","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Response Body Format","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"volumes\": [\n { \n \"id\": integer, \n \"bounds\": {\n \"lower\": [double, double, double], \n \"upper\": [double, double, double]\n },\n {\n \"id\": integer,\n \"bounds\": {\n \"lower\": [double, double, double],\n \"upper\": [double, double, double]\n }\n }\n }\n ]\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Example Response Body","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"volumes\": [\n {\n \"id\": \"/volumes/1\",\n \"bounds\": {\n \"lower\": [-0.5, -0.7, 0]\n \"upper\": [0.5, 0.7, 1.0]\n }\n }\n ]\n}","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Update","type":"text"}]},{"type":"paragraph","content":[{"text":"To update a volume, users ","type":"text"},{"text":"PUT","type":"text","marks":[{"type":"code"}]},{"text":" to the ","type":"text"},{"text":"/volumes/","type":"text","marks":[{"type":"code"}]},{"text":" endpoint providing the volume ID. The volume ID must exist already otherwise, the request errors out with a bad request error code. Updates must be idempotent, i.e., updates must be a full replacement of the volume details. ","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"f78ac460-b977-454b-81a2-6f7601f8a9ea"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[198.0]},"content":[{"type":"paragraph","content":[{"text":"Operation","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[562.0]},"content":[{"type":"paragraph","content":[{"text":"PUT","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[198.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[562.0]},"content":[{"type":"paragraph","content":[{"text":"Updates a volume or creates a new volume if the ID does not match any existing volume IDs. ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[198.0]},"content":[{"type":"paragraph","content":[{"text":"Request","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[562.0]},"content":[{"type":"codeBlock","content":[{"text":"PUT :/volumes/","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[198.0]},"content":[{"type":"paragraph","content":[{"text":"Request Body Format","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[562.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"volume\": { \n \"id\": integer, \n \"bounds\": {\n \"lower\": [double, double, double], \n \"upper\": [double, double, double]\n }\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[198.0]},"content":[{"type":"paragraph","content":[{"text":"Response Body Format","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[562.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"volume\": { \n \"id\": integer, \n \"bounds\": {\n \"lower\": [double, double, double], \n \"upper\": [double, double, double]\n }\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[198.0]},"content":[{"type":"paragraph","content":[{"text":"Example Request Body","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[562.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"volume\": {\n \"id\": 2,\n \"bounds\": {\n \"lower\": [0.0, 0.0, 0.0]\n \"upper\": [1.2, 1.2, 1.4]\n }\n }\n ]\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[198.0]},"content":[{"type":"paragraph","content":[{"text":"Example Response Body","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[562.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"volume\": {\n \"id\": 2,\n \"bounds\": {\n \"lower\": [0.0, 0.0, 0.0]\n \"upper\": [1.2, 1.2, 1.4]\n }\n }\n ]\n}","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Delete","type":"text"}]},{"type":"paragraph","content":[{"text":"To remove / delete a volume, users ","type":"text"},{"text":"DELETE","type":"text","marks":[{"type":"code"}]},{"text":" on the ","type":"text"},{"text":"/volumes/","type":"text","marks":[{"type":"code"}]},{"text":" endpoint providing the ID to remove. ","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"c5a6a6fb-87ca-41ae-9147-204e1b26c4c0"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[198.0]},"content":[{"type":"paragraph","content":[{"text":"Operation","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[562.0]},"content":[{"type":"paragraph","content":[{"text":"DELETE","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[198.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[562.0]},"content":[{"type":"paragraph","content":[{"text":"Removes a volume. ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[198.0]},"content":[{"type":"paragraph","content":[{"text":"Request","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[562.0]},"content":[{"type":"codeBlock","content":[{"text":"DELETE :/volumes/","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[198.0]},"content":[{"type":"paragraph","content":[{"text":"Request Body Format","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[562.0]},"content":[{"type":"paragraph","content":[{"text":"None.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[198.0]},"content":[{"type":"paragraph","content":[{"text":"Response Body Format","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[562.0]},"content":[{"type":"paragraph","content":[{"text":"None.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"Status","type":"text"}]},{"type":"bodiedExtension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt","parameters":{"macroParams":{"name":{"value":"Get RapidSense Status"}},"macroMetadata":{"macroId":{"value":"2740deee7f53d5a6facd289e96e6a298"},"schemaVersion":{"value":"1"},"title":"Excerpt"}},"localId":"d8c77f5a-ae43-42fa-91eb-6a0f19949bc0"},"content":[{"type":"paragraph","content":[{"text":"Users of the system can query the status of RapidSense either via the ASCII interface through the ","type":"text"},{"text":"GetRapidSenseStatus","type":"text","marks":[{"type":"strong"}]},{"text":" command or via the REST interface through the ","type":"text"},{"text":"/status","type":"text","marks":[{"type":"code"}]},{"text":" endpoint.","type":"text"}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1400,"id":"72dc106c-fafc-48e3-abbd-13a15c005163","collection":"contentId-3467120157","type":"file","height":467}}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":4},"content":[{"text":"ASCII Message Definition","type":"text"}]},{"type":"bodiedExtension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt","parameters":{"macroParams":{"name":{"value":"Get RapidSense Status ASCII"}},"macroMetadata":{"macroId":{"value":"3d03842d-42d3-485b-b8fe-12aaf09da00e"},"schemaVersion":{"value":"1"},"title":"Excerpt"}},"localId":"3d305896-18ae-4565-bb2a-6e64a2e43849"},"content":[{"type":"table","attrs":{"layout":"default","localId":"1c162084-924b-44ff-a5b1-848f579c05b9"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[190.0]},"content":[{"type":"paragraph","content":[{"text":"Structure","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[536.0]},"content":[{"type":"codeBlock","content":[{"text":"{topic: GetRapidSenseStatus}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[190.0]},"content":[{"type":"paragraph","content":[{"text":"Argument Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[536.0]},"content":[{"type":"paragraph","content":[{"text":"N/A","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[190.0]},"content":[{"type":"paragraph","content":[{"text":"Function Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[536.0]},"content":[{"type":"paragraph","content":[{"text":"This command can be called as soon as the RTR controller accepts a socket. It returns the latest status of RapidSense.","type":"text"}]},{"type":"paragraph","content":[{"text":"All returned values are strings.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[190.0]},"content":[{"type":"paragraph","content":[{"text":"Response Details","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[536.0]},"content":[{"type":"paragraph","content":[{"text":"The response details contains a list of rapid sense state and error codes.","type":"text"}]},{"type":"paragraph","content":[{"text":"The format is “","type":"text"},{"text":"GetRapidSenseStatus,,,

,","type":"text","marks":[{"type":"strong"}]},{"text":"”","type":"text"}]},{"type":"paragraph","content":[{"text":"Parameter descriptions:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"RapidSense Version","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"major.minor.build","type":"text","marks":[{"type":"em"}]}]}]}]},{"type":"paragraph","content":[{"text":"RapidSense State","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"IDLE (0), CALIBRATING (1), OPERATING (2), FATAL (3)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Sensor Status(es)","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A mapping of sensor serial number to an integer representing the sensor state.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"UNKNOWN(0), DISCONNECTED(1), UNCALIBRATED(2), CALIBRATED(3) ","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Active RapidSense Error Code(s) ","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A list of actives errors in form of error codes: 5xxx (any integer in the range 5000-5999 is a RapidSense error code, NOTE: not all are used!) Refer to table 1 below for recovery strategies.","type":"text"}]}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[190.0]},"content":[{"type":"paragraph","content":[{"text":"Example CSV Request","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[536.0]},"content":[{"type":"codeBlock","content":[{"text":"GetRapidSenseStatus","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[190.0]},"content":[{"type":"paragraph","content":[{"text":"Example YAML Response","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[536.0]},"content":[{"type":"codeBlock","content":[{"text":"{topic: GetRapidSenseStatus, type: Response, data: {rapidsense_version: 0.2.0, rapidsense_mode: IDLE, sensor_status: [inbound: 1, pallet-left: 1, pallet-right: 1], error_list: []}}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[190.0]},"content":[{"type":"paragraph","content":[{"text":"Example CSV Responses","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[536.0]},"content":[{"type":"codeBlock","content":[{"text":"GetRapidSenseStatus,2.0.0,2,inbound,1,pallet-left,1,pallet-right,1,2,5002,5031\nGetRapidSenseStatus,2.0.0,1,inbound,1,pallet-left,1,pallet-right,1,1,0\nGetRapidSenseStatus,2.0.0,1,inbound,1,pallet-left,1,pallet-right,1,2,5102,5103","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"REST Endpoint & JSON Message Definition","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"290ec6c0-93a1-4228-bc1a-cf7813cb10bf"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[197.0]},"content":[{"type":"paragraph","content":[{"text":"Endpoint","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[563.0]},"content":[{"type":"codeBlock","content":[{"text":"/status","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[197.0]},"content":[{"type":"paragraph","content":[{"text":"Operation","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[563.0]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[197.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[563.0]},"content":[{"type":"paragraph","content":[{"text":"Returns the status of RapidSense.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[197.0]},"content":[{"type":"paragraph","content":[{"text":"Response Body Format","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[563.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"version\": major.minor.patch,\n \"state\": string,\n \"sensors\": [{\"serial_number\": string, \"calibration_status\": string}],\n \"error_codes\": [integer, ...]\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[197.0]},"content":[{"type":"paragraph","content":[{"text":"Example Request Body","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[563.0]},"content":[{"type":"codeBlock","content":[{"text":"GET localhost:11235/status","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[197.0]},"content":[{"type":"paragraph","content":[{"text":"Example Response Body","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[563.0]},"content":[{"type":"codeBlock","content":[{"text":"{\"version\": \"0.1.2\", \"state\": \"operating\", \"sensors\": [{\"serial_number\": \"213509183b\", \"calibration_status\": \"calibrated\"}, {\"serial_number\": \"53134952f\", \"calibration_status\": \"uncalibrated\"}], \"error_codes\": [5001, 5505]}","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"Scan Scene","type":"text"}]},{"type":"bodiedExtension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt","parameters":{"macroParams":{"name":{"value":"ScanSceneDescription"}},"macroMetadata":{"macroId":{"value":"0efb6682b3138c6f330e8a2c9b647f53"},"schemaVersion":{"value":"1"},"title":"Excerpt"}},"localId":"c8528e99-097a-4a49-99ca-533169de10e7"},"content":[{"type":"paragraph","content":[{"text":"Users can scan the scene using 4 modes: snapshot, streaming, off, and clear. These operations affect the motion planning, enabling dynamic collision avoidance.","type":"text"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"ASCII Message Definition","type":"text"}]},{"type":"bodiedExtension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt","parameters":{"macroParams":{"name":{"value":"ScanScene ASCII"}},"macroMetadata":{"macroId":{"value":"683b262b5d1b298e27224f2ae5d79a7a"},"schemaVersion":{"value":"1"},"title":"Excerpt"}},"localId":"50238d26-253a-4e1c-b4c2-de33ae423499"},"content":[{"type":"table","attrs":{"layout":"default","localId":"6607979d-c2e2-404b-9258-b8d0523c1cdb"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[190.0]},"content":[{"type":"paragraph","content":[{"text":"Structure","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[536.0]},"content":[{"type":"codeBlock","content":[{"text":"ScanScene","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[190.0]},"content":[{"type":"paragraph","content":[{"text":"CSV Arguments + Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[536.0]},"content":[{"type":"paragraph","content":[{"text":"The mode by which to scan the scene:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Start streaming = 1","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Stop streaming = 2","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Clear = 3","type":"text"}]}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[190.0]},"content":[{"type":"paragraph","content":[{"text":"YAML Arguments + Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[536.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Start streaming = “start_streaming”","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Stop streaming = “stop_streaming”","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Clear = “clear”","type":"text"}]}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[190.0]},"content":[{"type":"paragraph","content":[{"text":"Function Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[536.0]},"content":[{"type":"paragraph","content":[{"text":"This command changes the scanning mode for RapidSense.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[190.0]},"content":[{"type":"paragraph","content":[{"text":"Response Details","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[536.0]},"content":[{"type":"paragraph","content":[{"text":"Whether the system is set to the requested mode.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[190.0]},"content":[{"type":"paragraph","content":[{"text":"Example CSV Request","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[536.0]},"content":[{"type":"codeBlock","content":[{"text":"ScanScene,1","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[190.0]},"content":[{"type":"paragraph","content":[{"text":"Example CSV Response","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[536.0]},"content":[{"type":"codeBlock","content":[{"text":"ScanScene,1,0 // success\nScanScene,1,5102 // failure","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[190.0]},"content":[{"type":"paragraph","content":[{"text":"Example YAML Request","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[536.0]},"content":[{"type":"codeBlock","content":[{"text":"{topic: ScanScene, data: {type: \"start_streaming\"}}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[190.0]},"content":[{"type":"paragraph","content":[{"text":"Example YAML Response","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[536.0]},"content":[{"type":"codeBlock","content":[{"text":"{topic: ScanScene, response: {}}","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"Calibration Setup","type":"text"}]},{"type":"paragraph","content":[{"text":"Users can setup RapidSense for calibration through the sensors and markers interfaces. ","type":"text"}]},{"type":"heading","attrs":{"level":3},"marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"Markers","type":"text"}]},{"type":"paragraph","content":[{"text":"Markers are persisted between usages of RapidSense. Users can create, read, update, and delete markers for the system. Not all requests require the ","type":"text"},{"text":"{id}","type":"text","marks":[{"type":"code"}]},{"text":"field. ","type":"text"},{"text":"The marker ID is the resource ID, as far as REST semantics is concerned","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"dad5da21-978c-4e22-ab4d-305a13389e8c"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Endpoint","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","content":[{"text":"/markers/{id}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Supported Operations","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"paragraph","content":[{"text":"GET, PUT, POST, PATCH, DELETE","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Base Endpoint","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","content":[{"text":":/markers/{id}","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Read","type":"text"}]},{"type":"paragraph","content":[{"text":"To receive a list of all markers configured for RapidSense, users can perform a ","type":"text"},{"text":"GET","type":"text","marks":[{"type":"code"}]},{"text":" on the ","type":"text"},{"text":"/markers","type":"text","marks":[{"type":"code"}]},{"text":" endpoint and receive a list of all marker information. To receive a specific marker, users can perform a ","type":"text"},{"text":"GET","type":"text","marks":[{"type":"code"}]},{"text":" providing the marker’s ID in the ","type":"text"},{"text":"{id}","type":"text","marks":[{"type":"code"}]},{"text":" field. ","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"2d610769-2a0c-49ec-a031-dcb24a1efb05"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Operation","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"paragraph","content":[{"text":"Returns a list of ","type":"text"},{"text":"all","type":"text","marks":[{"type":"strong"}]},{"text":" markers in the system.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Request","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","content":[{"text":"GET :/markers","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Response Body Format","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"markers\": [\n {\n \"id\": integer, // marker id\n \"length\": float, // meters\n \"robot\"?: string // optional name of the robot this marker is mounted to\n },\n ...\n ]\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Example Response Body","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"markers\": [\n { \n \"id\": 319, // marker id\n \"length\": 0.254,\n \"robot\"?: \"lab_1_mitsu\" // optional name of the robot this marker is mounted to\n },\n { \n \"id\": 125,\n \"length\": 0.254,\n // no robot parameter indicates a stationary target\n },\n ]\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP Code Responses","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"paragraph","content":[{"text":"N/A - returns an empty list if no markers exist. ","type":"text"}]}]}]}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"e76e771d-bfc2-49d5-a046-645afdf19886"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Operation","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"paragraph","content":[{"text":"Returns a single marker by its ID.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Request","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","content":[{"text":"GET :/markers/{id}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Response Body Format","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"marker\": {\n \"id\": integer,\n \"length\": float, // meters\n \"robot\": string // optional name of the robot this marker is mounted to\n } \n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Example Response Body","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"marker\": { \n \"id\": 319,\n \"length\": 0.254,\n \"robot\": \"lab_1_mitsu\" // optional key-value pair for the robot to which this marker is mounted\n }\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP Code Responses","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"paragraph","content":[{"text":"404","type":"text","marks":[{"type":"code"}]},{"text":" If no marker exists for that ID.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Create, Update, or Delete","type":"text"}]},{"type":"paragraph","content":[{"text":"The above data format can also be used to create new markers, update existing markers, or delete markers from the system.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"d155bccd-8cd0-470a-a11c-b648961623aa"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Operation","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"paragraph","content":[{"text":"Create a single marker. ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Request","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","content":[{"text":"POST :/markers","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Request Body Format","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"markers\": [\n { \n \"id\": integer,\n \"length\": float, // meters\n \"robot\"?: string // optional name of the robot this marker is mounted to\n },\n ]\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Example Response Body","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{ // a list of all markers is returned\n \"markers\": [\n { \n \"id\": 319,\n \"length\": 0.254,\n \"robot\"?: \"lab_1_mitsu\" // optional name of the robot this marker is mounted to\n },\n { \n \"marker_id\": 125,\n \"length\": 0.254,\n // no robot parameter indicates a stationary target\n },\n ]\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP Code Responses","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"paragraph","content":[{"text":"422 Unprocessable Content","type":"text","marks":[{"type":"code"}]},{"text":" - One or more markers with the provided IDs already exists, the ID is outside the range of the ","type":"text"},{"text":"36h11","type":"text","marks":[{"type":"code"}]},{"text":" tag family, or the length is outside the acceptable range.","type":"text"}]},{"type":"paragraph","content":[{"text":"200 OK","type":"text","marks":[{"type":"code"}]},{"text":" - Response accepted","type":"text"}]}]}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":3},"marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"Sensors","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"The sensors endpoint is automatically populated with detected sensors. Any sensors that are not configured meaning not setup for calibration, return default values regarding their calibration setup. The following table details the general REST endpoint information needed to setup calibration for a sensor.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"dd258163-31c7-4fd2-96a7-09629a4239ac"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Endpoint","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","content":[{"text":"/sensors/{id}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Supported Operations","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"paragraph","content":[{"text":"GET and PATCH","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Base Endpoint","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","content":[{"text":":/sensors/{id}","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Read","type":"text"}]},{"type":"paragraph","content":[{"text":"To read a list of all sensor configurations for RapidSense, users can perform a ","type":"text"},{"text":"GET","type":"text","marks":[{"type":"code"}]},{"text":" on the ","type":"text"},{"text":"/sensors","type":"text","marks":[{"type":"code"}]},{"text":" endpoint and receive a list of all sensor information including the resource’s ID. Additionally, users can perform a ","type":"text"},{"text":"GET","type":"text","marks":[{"type":"code"}]},{"text":" on a single sensor using the sensor’s resource ID. ","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"b8b6dabf-18da-426e-a45e-b491c0919847"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Operation","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"paragraph","content":[{"text":"Returns a list of all detected sensors in the system.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Request","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","content":[{"text":"GET :/sensors/{id}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Response Body Format","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"sensors\": [{ \n \"id\": integer,\n \"name\": string,\n \"mfg_info\": {\n \"manufacturer\": string,\n \"model\": string,\n \"serial_number\": string\n },\n \"pose\": double array of 16-elements,\n \"frustum\": {\n \"hfov\": float,\n \"vfov\": float,\n \"near_clip\": float,\n \"far_clip\": float\n },\n \"active\": boolean,\n \"calibration\": {\n \"last_calibrated\": string, // format YYYY-MM-DD HH:mm\n \"markers\": [\n {\n \"marker_id\": integer,\n \"cal_target\": string, // only returned if marker has robot field populated\n },\n ...\n ] \n }\n }\n }\n ]\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Example Response Body","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"sensors\": [{\n \"id\": 1,\n \"name\": \"pallet\",\n \"mfg_info\": {\n \"manufacturer\": \"Intel\",\n \"model\": \"D455\",\n \"serial_number\": \"123abe45613f\"\n },\n \"pose\": [1.0, 0.0, 0.0, 0.0, 0.0, 1.0, 0.0, 0.0, 0.0, 0.0, 1.0, 0.0, 0.0, 0.0, 0.0, 1.0],\n \"frustum\": {\n \"hfov\": \"240\",\n \"vfov\": \"320\",\n \"near_clip\": 0.5,\n \"far_clip\": 2.5\n },\n \"active\": true,\n \"calibration\": {\n \"last_calibrated\": \"2024-01-02 11:48\",\n \"markers\": [\n {\n \"cal_target\": \"lab1_mitsu_calibration_12345\",\n \"marker_id\": 6,\n },\n {\n \"marker_id\": 2,\n }\n ]\n }\n ]\n}","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Update","type":"text"}]},{"type":"paragraph","content":[{"text":"To update a sensor’s calibration setup information, users can perform a ","type":"text"},{"text":"PATCH","type":"text","marks":[{"type":"code"}]},{"text":" on ","type":"text"},{"text":"/sensors/","type":"text","marks":[{"type":"code"}]},{"text":". Users associate a marker to a sensor. If a stationary marker is not being used or set, users do not provide that object.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"95c4ccf7-8571-433e-8aa1-dd4e0fc93282"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[198.0]},"content":[{"type":"paragraph","content":[{"text":"Operation","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[562.0]},"content":[{"type":"paragraph","content":[{"text":"PATCH","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[198.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[562.0]},"content":[{"type":"paragraph","content":[{"text":"Updates a sensor’s calibration parameters. ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[198.0]},"content":[{"type":"paragraph","content":[{"text":"Request","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[562.0]},"content":[{"type":"codeBlock","content":[{"text":"PATCH :/sensors/","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[198.0]},"content":[{"type":"paragraph","content":[{"text":"Request Body Format","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[562.0]},"content":[{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"markers\": {\n {\n \"marker_id\": integer,\n \"cal_target\": string, // only provided if marker is associated with a robot\n },\n }\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[198.0]},"content":[{"type":"paragraph","content":[{"text":"Example Request Body","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[562.0]},"content":[{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"markers\": [\n {\n \"marker_id\": 6,\n \"cal_target\": \"lab1_mitsu_calibration_12345\",\n },\n {\n \"marker_id\": 2,\n }\n ]\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[198.0]},"content":[{"type":"paragraph","content":[{"text":"Example Response Body","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[562.0]},"content":[{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"id\": 1,\n \"name\": \"pallet\",\n \"mfg_info\": {\n \"manufacturer\": \"Intel\",\n \"model\": \"D455\",\n \"serial_number\": \"123abe45613f\"\n },\n \"pose\": [1.0, 0.0, 0.0, 0.0, 0.0, 1.0, 0.0, 0.0, 0.0, 0.0, 1.0, 0.0, 0.0, 0.0, 0.0, 1.0],\n \"frustum\": {\n \"hfov\": \"240\",\n \"vfov\": \"320\",\n \"near_clip\": 0.5,\n \"far_clip\": 2.5\n },\n \"active\": true,\n \"calibration\": {\n \"last_calibrated\": \"2024-01-02 11:48\",\n \"markers\": [\n {\n \"marker_id\": 6,\n \"cal_target\": \"lab1_mitsu_calibration_12345\",\n },\n {\n \"marker_id\": 2,\n }\n ]\n }\n}","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"Calibrating","type":"text"}]},{"type":"paragraph","content":[{"text":"A user of the system (e.g., a script) can move the robot with a calibration standard to a certain location and initiate the calibration of a sensor, then move onto the next sensor until complete. The calibration process is coordinated by the calibration service.","type":"text"}]},{"type":"heading","attrs":{"level":3},"marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"Height Check (formerly Query Clearance)","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"General description","type":"text"}]},{"type":"paragraph","content":[{"text":"An area within a volume can be queried for its maximum height. This can be used for querying a placement location for a package on a pallet, as an example. The caller in this case would compute the difference in the height of the expected landing spot for that package and the actual landing spot returned by height check and adjust the place location height.","type":"text"}]},{"type":"paragraph","content":[{"text":"Users can create, read, update, and delete height check filter objects and adjust their parameters. Creation of filter objects and adjusting the filter parameters can only be performed via the REST interface. To query the filter for heights, users have the option of using the ASCII interface or the REST interface.","type":"text"}]},{"type":"bodiedExtension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt","parameters":{"macroParams":{"name":{"value":"Volumes_REST"}},"macroMetadata":{"macroId":{"value":"a204486d-b904-44ef-84bc-ab81d2155164"},"schemaVersion":{"value":"1"},"title":"Excerpt"}},"localId":"b1bae226-fe50-4a24-bf34-1a923b96972b"},"content":[{"type":"table","attrs":{"layout":"default","localId":"af75fca6-f81d-4238-9ce5-0ae1b6a5c620"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[190.0]},"content":[{"type":"paragraph","content":[{"text":"Endpoint","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[536.0]},"content":[{"type":"codeBlock","content":[{"text":"/heights","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[190.0]},"content":[{"type":"paragraph","content":[{"text":"Supported Operations","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[536.0]},"content":[{"type":"paragraph","content":[{"text":"GET, PATCH, POST, PUT, and DELETE","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[190.0]},"content":[{"type":"paragraph","content":[{"text":"Base Endpoint","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[536.0]},"content":[{"type":"codeBlock","content":[{"text":":/heights","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Create","type":"text"}]},{"type":"paragraph","content":[{"text":"To create an instance of the height check filter, users must ","type":"text"},{"text":"POST","type":"text","marks":[{"type":"code"}]},{"text":" on the ","type":"text"},{"text":"/heights","type":"text","marks":[{"type":"code"}]},{"text":" endpoint, providing the volume ID within the request body.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"2c6ed851-9c64-4365-b003-54db14edebbc"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Operation","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"paragraph","content":[{"text":"Creates a volume.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Request","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","content":[{"text":"POST :/heights","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Request Body Format","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","content":[{"text":"{\"volume_id\": integer}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Response Body Format","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"height_filter\": { \n \"id\": integer, \n \"parameters\": {\n \"integration_time\": double, // units in milliseconds, default of 100ms\n \"erosion\": double // units in meters\n }\n }\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Example Response Body","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"height_filter\": {\n \"id\": 1,\n \"parameters\": {\n \"integration_time\": 100.0,\n \"erosion\": 0.02\n }\n }\n ]\n}","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Read","type":"text"}]},{"type":"paragraph","content":[{"text":"To read a list of all height filters configured in RapidSense, users can perform a GET on the /heights endpoint and receive a list of all volumes with their IDs and bounds.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"a3f33e6f-1821-4535-81a7-dfa3918e6b86"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Operation","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"paragraph","content":[{"text":"Returns a list of all configured volumes in the system.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Request","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","content":[{"text":"GET :/heights","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Response Body Format","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"height_filters\": [{ \n \"id\": integer, \n \"parameters\": {\n \"integration_time\": double,\n \"erosion\": double\n }\n }\n ]\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Example Response Body","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"height_filters\": [\n {\n \"id\": 1,\n \"parameters\": {\n \"integration_time\": 100.0,\n \"erosion\": 0.02\n }\n }\n ]\n}","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Update","type":"text"}]},{"type":"paragraph","content":[{"text":"To update a filter’s parameter(s), users can perform a ","type":"text"},{"text":"PUT","type":"text","marks":[{"type":"code"}]},{"text":" on ","type":"text"},{"text":"/heights/","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"c2aeb71e-cb55-4c0e-9088-4d7e6d61dfb4"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[198.0]},"content":[{"type":"paragraph","content":[{"text":"Operation","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[562.0]},"content":[{"type":"paragraph","content":[{"text":"PUT","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[198.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[562.0]},"content":[{"type":"paragraph","content":[{"text":"Updates a height filter’s parameters. ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[198.0]},"content":[{"type":"paragraph","content":[{"text":"Request","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[562.0]},"content":[{"type":"codeBlock","content":[{"text":"PUT :/heights/","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[198.0]},"content":[{"type":"paragraph","content":[{"text":"Request Body Format","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[562.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"height_filter\": { \n \"id\": integer, \n \"parameters\": {\n \"integration_time\": double,\n \"erosion\": double,\n }\n }\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[198.0]},"content":[{"type":"paragraph","content":[{"text":"Response Body Format","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[562.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"height_filter\": { \n \"id\": integer, \n \"parameters\": {\n \"integration_time\": double,\n \"erosion\": double\n }\n }\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[198.0]},"content":[{"type":"paragraph","content":[{"text":"Example Request Body","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[562.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"height_filter\": { \n \"id\": integer, \n \"parameters\": {\n \"integration_time\": double,\n \"erosion\": double\n }\n }\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[198.0]},"content":[{"type":"paragraph","content":[{"text":"Example Response Body","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[562.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"height_filter\": { \n \"id\": 1, \n \"parameters\": {\n \"integration_time\": 123.0,\n \"erosion\": 0.04\n }\n }\n}","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Delete","type":"text"}]},{"type":"paragraph","content":[{"text":"To remove / delete a height filter, users ","type":"text"},{"text":"DELETE","type":"text","marks":[{"type":"code"}]},{"text":" on the ","type":"text"},{"text":"/heights/","type":"text","marks":[{"type":"code"}]},{"text":" endpoint providing the ID to remove.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"133abcfc-c8f2-4ad9-a63d-a764cfc6601c"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[198.0]},"content":[{"type":"paragraph","content":[{"text":"Operation","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[562.0]},"content":[{"type":"paragraph","content":[{"text":"DELETE","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[198.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[562.0]},"content":[{"type":"paragraph","content":[{"text":"Removes a height filter. ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[198.0]},"content":[{"type":"paragraph","content":[{"text":"Request","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[562.0]},"content":[{"type":"codeBlock","content":[{"text":"DELETE :/heights/","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[198.0]},"content":[{"type":"paragraph","content":[{"text":"Request Body Format","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[562.0]},"content":[{"type":"paragraph","content":[{"text":"None.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[198.0]},"content":[{"type":"paragraph","content":[{"text":"Response Body Format","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[562.0]},"content":[{"type":"paragraph","content":[{"text":"None.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"To query heights","type":"text"}]},{"type":"paragraph","content":[{"text":"Users can query the maximum height of a specified area via the ASCII interface or the REST interface. Users specify the centroid (the x / y center point) along with the length (distance along the x-axis) and width (distance along the y-axis) of the area to query for height. The maximum height in that specified area is returned in units of meters. Below are details regarding both the ASCII and REST interfaces.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"ASCII Message Definition","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"bc03a8f9-e840-4878-a8bf-5c9ac04064ca"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[197.0]},"content":[{"type":"paragraph","content":[{"text":"Structure","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[563.0]},"content":[{"type":"codeBlock","content":[{"text":"{topic: HeightCheck, data: {id: string, centroid: [double, double], width: double, length: double}}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[197.0]},"content":[{"type":"paragraph","content":[{"text":"Argument Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[563.0]},"content":[{"type":"paragraph","content":[{"text":"id","type":"text","marks":[{"type":"strong"}]},{"text":": the ID of the filter instance (returned when a user POSTs on ","type":"text"},{"text":"/heights","type":"text","marks":[{"type":"code"}]},{"text":". ","type":"text"}]},{"type":"paragraph","content":[{"text":"centroid","type":"text","marks":[{"type":"strong"}]},{"text":": the center of the area as an x, y position relative to the volume’s origin (lowest x and y values). ","type":"text"}]},{"type":"paragraph","content":[{"text":"width: ","type":"text","marks":[{"type":"strong"}]},{"text":"the width of the area (along the x-axis).","type":"text"}]},{"type":"paragraph","content":[{"text":"length: ","type":"text","marks":[{"type":"strong"}]},{"text":"the height of the area (along the y-axis). ","type":"text"}]},{"type":"paragraph","content":[{"text":"NOTE","type":"text","marks":[{"type":"strong"}]},{"text":": Units are set by ","type":"text"},{"text":"SetUnits","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[197.0]},"content":[{"type":"paragraph","content":[{"text":"Function Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[563.0]},"content":[{"type":"paragraph","content":[{"text":"Height check uses the heuristic of maximum value within the specified area within the volume. ","type":"text"}]},{"type":"paragraph","content":[{"text":"NOTE","type":"text","marks":[{"type":"strong"}]},{"text":": ","type":"text"},{"text":"objects that are to be placed with significant overhang will bias the measurements so care should be taken in computing this value to allow overhangs but not bias the calculations to negatively impact system operations","type":"text","marks":[{"type":"em"}]},{"text":". This command can be run at any time while RapidSense is in OPERATING state.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[197.0]},"content":[{"type":"paragraph","content":[{"text":"Response Details","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[563.0]},"content":[{"type":"paragraph","content":[{"text":"The response contains a status for the operation and the height according to the heuristic (currently maximum value) in the units specified (by the ","type":"text"},{"text":"SetUnits","type":"text","marks":[{"type":"code"}]},{"text":" command) if the operation status was successful (i.e., 0). Upon failure, the error code is returned.","type":"text"}]},{"type":"paragraph","content":[{"text":"Status","type":"text","marks":[{"type":"em"}]},{"text":" indicates whether the query command was successful or whether an error was encountered. A status of 0 indicates the operation was a success. Otherwise, the error code is returned.","type":"text"},{"text":" If an error code is encountered, the clearance is not returned.","type":"text","marks":[{"type":"underline"},{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[197.0]},"content":[{"type":"paragraph","content":[{"text":"Example Request","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[563.0]},"content":[{"type":"codeBlock","content":[{"text":"{topic: HeightCheck, data: {id: 1, centroid: [500, 200], width: 100, length: 220}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[197.0]},"content":[{"type":"paragraph","content":[{"text":"Example Responses","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[563.0]},"content":[{"type":"codeBlock","content":[{"text":"{topic: HeightCheck, data: {status: 0, height: 130}}\n{topic: HeightCheck, data: {status: 5001}}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[197.0]},"content":[{"type":"paragraph","content":[{"text":"Example CSV Responses","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[563.0]},"content":[{"type":"codeBlock","content":[{"text":"HeightCheck,0,130\nHeightCheck,5001","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"REST Endpoint & JSON Message Definition","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"d062ac8c-f644-47ea-9262-be1cfdc8f270"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[197.0]},"content":[{"type":"paragraph","content":[{"text":"Endpoint","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[563.0]},"content":[{"type":"codeBlock","content":[{"text":"/heights//?cx={x}&cy={y}&width={width}&length={length}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[197.0]},"content":[{"type":"paragraph","content":[{"text":"Supported Operations","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[563.0]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[197.0]},"content":[{"type":"paragraph","content":[{"text":"Function Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[563.0]},"content":[{"type":"paragraph","content":[{"text":"The heights endpoint provides callers the height according to the heuristic of maximum value within a specified area.","type":"text"}]},{"type":"paragraph","content":[{"text":"The parameters are the centroid 2D point (cx, cy) and the width and length of the area of interest (all units in meters).","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[197.0]},"content":[{"type":"paragraph","content":[{"text":"Response Details","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[563.0]},"content":[{"type":"paragraph","content":[{"text":"The response is the maximum height in meters.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[197.0]},"content":[{"type":"paragraph","content":[{"text":"Example Request","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[563.0]},"content":[{"type":"codeBlock","content":[{"text":"GET localhost:11235/heights/1/?cx=0.450&cy=0.789&width=0.110&length=0.120","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[197.0]},"content":[{"type":"paragraph","content":[{"text":"Example Response","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[563.0]},"content":[{"type":"codeBlock","content":[{"text":"{\"height\": 0.123}","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"Change Detection(under development)","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"General description","type":"text"}]},{"type":"paragraph","content":[{"text":"Users can inspect a volume for deviations from a expected template built by adding objects to a volume and then querying for the deviations. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Users can create, read, update, and delete change detection filter objects and adjust their parameters. Creation of filter objects and adjusting the filter parameters can only be performed via the REST interface. To query the filter for changes, users have the option of using the ASCII interface or the REST interface.","type":"text"}]},{"type":"bodiedExtension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt","parameters":{"macroParams":{"name":{"value":"Volumes_REST"}},"macroMetadata":{"macroId":{"value":"ef892ce4-eb57-4b67-bbb6-ba1b3c6da957"},"schemaVersion":{"value":"1"},"title":"Excerpt"}},"localId":"3631280b-6907-4135-8310-a5ea3d635c4e"},"content":[{"type":"table","attrs":{"layout":"default","localId":"7711ac74-1ca8-477c-a900-197303825139"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[190.0]},"content":[{"type":"paragraph","content":[{"text":"Endpoints","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[536.0]},"content":[{"type":"codeBlock","content":[{"text":"/changes\n/changes//objects","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[190.0]},"content":[{"type":"paragraph","content":[{"text":"Supported Operations","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[536.0]},"content":[{"type":"paragraph","content":[{"text":"GET, PATCH, POST, PUT, and DELETE","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[190.0]},"content":[{"type":"paragraph","content":[{"text":"Base Endpoints","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[536.0]},"content":[{"type":"codeBlock","content":[{"text":":/changes\n:/changes//objects","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Create (filter)","type":"text"}]},{"type":"paragraph","content":[{"text":"To create an instance of the change detection filter, users must ","type":"text"},{"text":"POST","type":"text","marks":[{"type":"code"}]},{"text":" on the ","type":"text"},{"text":"/changes","type":"text","marks":[{"type":"code"}]},{"text":" endpoint, providing the volume ID within the request body.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"c00f7e65-fbf1-4d70-9b6a-5fbd4518975c"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Operation","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"paragraph","content":[{"text":"Creates a volume.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Request","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","content":[{"text":"POST :/changes","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Request Body Format","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","content":[{"text":"{\"volume_id\": integer}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Response Body Format","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"change_detection_filter\": { \n \"id\": integer, \n \"parameters\": {\n \"timeout\": double // units in milliseconds, default of 100ms\n }\n }\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Example Response Body","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"change_detection_filter\": {\n \"id\": 1,\n \"parameters\": {\n \"timeout\": 100.0\n }\n }\n ]\n}","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Read (filter)","type":"text"}]},{"type":"paragraph","content":[{"text":"To read a list of all change detection filters configured in RapidSense, users can perform a ","type":"text"},{"text":"GET","type":"text","marks":[{"type":"code"}]},{"text":" on the ","type":"text"},{"text":"/changes","type":"text","marks":[{"type":"code"}]},{"text":" endpoint and receive a list of all filters with their IDs and attributes and objects added to the volume.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"b153d4ff-ef57-40ee-9640-94324b17f87d"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Operation","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"paragraph","content":[{"text":"Returns a list of all configured filters in the system.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Request","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","content":[{"text":"GET :/changes\nGET :/changes/","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Response Body Format","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"change_detection_filters\": [{ \n \"id\": integer, \n \"parameters\": {\n \"timeout\": double // timeout in milliseconds\n },\n \"objects\": [\n {\n \"id\": integer,\n \"centroid\": [double, double], // all values in meters\n \"length\": double,\n \"width\": double,\n \"height\": double\n }\n ]\n }\n ]\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Example Response Body","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"change_detection_filters\": [\n {\n \"id\": 1,\n \"parameters\": {\n \"timeout\": 3000.0\n },\n \"objects\": []\n }\n ]\n}","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Update (filter)","type":"text"}]},{"type":"paragraph","content":[{"text":"To update a filter’s parameter(s), users can perform a ","type":"text"},{"text":"PUT","type":"text","marks":[{"type":"code"}]},{"text":" on ","type":"text"},{"text":"/changes/","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"c41255bc-65b7-450e-ac5c-b88714bbbcff"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Operation","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"paragraph","content":[{"text":"PUT","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"paragraph","content":[{"text":"Creates a volume.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Request","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","content":[{"text":"POST :/changes","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Request Body Format","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","content":[{"text":"{\"volume_id\": integer}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Response Body Format","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"change_detection_filter\": { \n \"id\": integer, \n \"parameters\": {\n \"timeout\": double // units in milliseconds, default of 100ms\n }\n }\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[189.0]},"content":[{"type":"paragraph","content":[{"text":"Example Response Body","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[537.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"change_detection_filter\": {\n \"id\": 1,\n \"parameters\": {\n \"timeout\": 100.0\n }\n }\n ]\n}","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Delete (filter)","type":"text"}]},{"type":"paragraph","content":[{"text":"To remove / delete a change detection filter, users ","type":"text"},{"text":"DELETE","type":"text","marks":[{"type":"code"}]},{"text":" on the ","type":"text"},{"text":"/changes/","type":"text","marks":[{"type":"code"}]},{"text":" endpoint providing the ID to remove.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"1618782f-c0c3-45b4-a2c1-cd05c8b8c2a3"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[198.0]},"content":[{"type":"paragraph","content":[{"text":"Operation","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[562.0]},"content":[{"type":"paragraph","content":[{"text":"DELETE","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[198.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[562.0]},"content":[{"type":"paragraph","content":[{"text":"Removes a change detection filter. ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[198.0]},"content":[{"type":"paragraph","content":[{"text":"Request","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[562.0]},"content":[{"type":"codeBlock","content":[{"text":"DELETE :/changes/","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[198.0]},"content":[{"type":"paragraph","content":[{"text":"Request Body Format","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[562.0]},"content":[{"type":"paragraph","content":[{"text":"None.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[198.0]},"content":[{"type":"paragraph","content":[{"text":"Response Body Format","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[562.0]},"content":[{"type":"paragraph","content":[{"text":"None.","type":"text"}]}]}]}]}],"version":1}

Browser not supported