{"url":"/api-reference/robot-webservice/get-media-uris-for-every-configured-facet-of-a-robot","method":"POST","path":"/api/robot/getAllMediaUris","tag":"Robot Webservice","title":"Get media uris for every configured facet of a robot","operation":{"description":"Get the video uris of every video facet and the audio uris of every audio facet the robot has configured, so no uri is minted under a facet that cannot serve it","operationId":"getAllRobotMediaUris","parameters":[{"description":"Authentication scheme identifier. Use `api-token` for standard API key authentication, `partner-api-token` for partner API key authentication. Must be paired with the `x-auth-apikey` header containing your API key.","example":"api-token","in":"header","name":"x-auth-scheme","required":true,"schema":{"default":"api-token","enum":["api-token","api","partner-api-token","partner-api"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Robot_GetAllMediaUrisWSRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Robot_GetAllMediaUrisWSResponse"}}},"description":"OK"}},"summary":"Get media uris for every configured facet of a robot","tags":["Robot Webservice"]},"auth":{"headers":[{"description":"Your Rhombus API key. Must be accompanied by the `x-auth-scheme` header set to `api-token` (or `partner-api-token` for partner endpoints).","in":"header","name":"x-auth-apikey","type":"apiKey"}]},"components":{"schemas":{"Robot_GetAllMediaUrisWSRequest":{"description":"Request object for retrieving the media uris of every facet a robot has configured.","properties":{"deviceUuid":{"description":"base 64 (url-safe) uuid string","example":"AAAAAAAAAAAAAAAAAAAAAA","format":"RUUID","nullable":true,"type":"string"}},"type":"object"},"Robot_GetAllMediaUrisWSResponse":{"description":"Media uris for every configured facet of a robot, plus the robot's device-level uris.","properties":{"audioFacetUris":{"additionalProperties":{"$ref":"#/components/schemas/Robot_RobotAudioFacetUrisView"},"description":"Audio uris keyed by the audio facet that serves them","nullable":true,"type":"object"},"deviceUuid":{"description":"base 64 (url-safe) uuid string","example":"AAAAAAAAAAAAAAAAAAAAAA","format":"RUUID","nullable":true,"type":"string"},"lanCheckUrls":{"description":"List of LAN check URLs to verify robot availability on the local network. Not faceted","items":{"description":"List of LAN check URLs to verify robot availability on the local network. Not faceted","nullable":true,"type":"string"},"nullable":true,"type":"array"},"videoFacetUris":{"additionalProperties":{"$ref":"#/components/schemas/Robot_RobotVideoFacetUrisView"},"description":"Video uris keyed by the video facet that serves them","nullable":true,"type":"object"},"wanLiveRobotUri":{"description":"WAN URI for the robot control websocket. Not faceted","nullable":true,"type":"string"}},"type":"object"},"Robot_RobotAudioFacetUrisView":{"description":"Live uris for one audio facet of a robot.","properties":{"lanLiveOpusUris":{"description":"List of LAN URIs for the live Opus audio stream of this facet","items":{"description":"List of LAN URIs for the live Opus audio stream of this facet","nullable":true,"type":"string"},"nullable":true,"type":"array"},"wanLiveOpusUri":{"description":"WAN URI for the live Opus audio stream of this facet","nullable":true,"type":"string"}},"type":"object"},"Robot_RobotVideoFacetUrisView":{"description":"Live and VOD uris for one video facet of a robot.","properties":{"lanLiveH264Uris":{"description":"List of LAN URIs for the live realtime video stream of this facet","items":{"description":"List of LAN URIs for the live realtime video stream of this facet","nullable":true,"type":"string"},"nullable":true,"type":"array"},"lanLiveM3u8Uris":{"description":"List of LAN URIs for the live M3U8 stream of this facet","items":{"description":"List of LAN URIs for the live M3U8 stream of this facet","nullable":true,"type":"string"},"nullable":true,"type":"array"},"lanLiveMpdUris":{"description":"List of LAN URIs for the live MPD stream of this facet","items":{"description":"List of LAN URIs for the live MPD stream of this facet","nullable":true,"type":"string"},"nullable":true,"type":"array"},"lanVodM3u8UrisTemplates":{"description":"List of LAN URI templates for VOD M3U8 streams of this facet","items":{"description":"List of LAN URI templates for VOD M3U8 streams of this facet","nullable":true,"type":"string"},"nullable":true,"type":"array"},"lanVodMpdUrisTemplates":{"description":"List of LAN URI templates for VOD MPD streams of this facet","items":{"description":"List of LAN URI templates for VOD MPD streams of this facet","nullable":true,"type":"string"},"nullable":true,"type":"array"},"wanLiveH264Uri":{"description":"WAN URI for the live realtime video stream of this facet","nullable":true,"type":"string"},"wanLiveM3u8Uri":{"description":"WAN URI for the live M3U8 stream of this facet","nullable":true,"type":"string"},"wanLiveMpdUri":{"description":"WAN URI for the live MPD stream of this facet","nullable":true,"type":"string"},"wanVodM3u8UriTemplate":{"description":"WAN URI template for VOD M3U8 streams of this facet","nullable":true,"type":"string"},"wanVodMpdUriTemplate":{"description":"WAN URI template for VOD MPD streams of this facet","nullable":true,"type":"string"}},"type":"object"}},"securitySchemes":{"ApiKeyAuth":{"description":"Your Rhombus API key. Must be accompanied by the `x-auth-scheme` header set to `api-token` (or `partner-api-token` for partner endpoints).","in":"header","name":"x-auth-apikey","type":"apiKey"},"oauth2":{"description":"OAuth 2.0 authorization code flow with PKCE (`S256`). Send the access token as `Authorization: Bearer <token>`. Each operation lists the scopes it requires; a token without them is refused 403 with `WWW-Authenticate: Bearer error=\"insufficient_scope\"`.","flows":{"authorizationCode":{"authorizationUrl":"https://console.rhombus.com/oauth/authorize","refreshUrl":"https://auth-web.rhombussystems.com/oauth/token","scopes":{"physical":"Unlock doors and elevators, lockdown, alarms, speakers and robots","read":"View cameras, footage and settings","write":"Change settings and data"},"tokenUrl":"https://auth-web.rhombussystems.com/oauth/token"}},"type":"oauth2"}}},"highlight":{"samples":{"cURL":[["text-code-function","curl"],[""," "],["text-code-string","--request"],[""," "],["text-code-string","POST"],[""," \\\n  "],["text-code-string","--url"],[""," "],["text-code-punctuation","'"],["text-code-string","https://api2.rhombussystems.com/api/robot/getAllMediaUris"],["text-code-punctuation","'"],[""," \\\n  "],["text-code-string","--header"],[""," "],["text-code-punctuation","'"],["text-code-string","x-auth-scheme: api-token"],["text-code-punctuation","'"],[""," \\\n  "],["text-code-string","--header"],[""," "],["text-code-punctuation","'"],["text-code-string","x-auth-apikey: YOUR_API_KEY"],["text-code-punctuation","'"],[""," \\\n  "],["text-code-string","--header"],[""," "],["text-code-punctuation","'"],["text-code-string","Content-Type: application/json"],["text-code-punctuation","'"],[""," \\\n  "],["text-code-string","--data"],[""," "],["text-code-punctuation","'"],["text-code-string","{"],["","\n"],["text-code-string","    \"deviceUuid\": \"AAAAAAAAAAAAAAAAAAAAAA\""],["","\n"],["text-code-string","  }"],["text-code-punctuation","'"]],"Python":[["text-code-keyword","import"],[""," requests\n\nurl "],["text-code-punctuation","="],[""," "],["text-code-punctuation","\""],["text-code-string","https://api2.rhombussystems.com/api/robot/getAllMediaUris"],["text-code-punctuation","\""],["","\nheaders "],["text-code-punctuation","="],[""," "],["text-code-punctuation","{"],["","\n    "],["text-code-punctuation","\""],["text-code-string","x-auth-scheme"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","\""],["text-code-string","api-token"],["text-code-punctuation","\","],["","\n    "],["text-code-punctuation","\""],["text-code-string","x-auth-apikey"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","\""],["text-code-string","YOUR_API_KEY"],["text-code-punctuation","\","],["","\n    "],["text-code-punctuation","\""],["text-code-string","Content-Type"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","\""],["text-code-string","application/json"],["text-code-punctuation","\","],["","\n"],["text-code-punctuation","}"],["","\npayload "],["text-code-punctuation","="],[""," "],["text-code-punctuation","{"],["","\n    "],["text-code-punctuation","\""],["text-code-string","deviceUuid"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","\""],["text-code-string","AAAAAAAAAAAAAAAAAAAAAA"],["text-code-punctuation","\""],["","\n"],["text-code-punctuation","}"],["","\n\nresponse "],["text-code-punctuation","="],[""," requests"],["text-code-punctuation","."],["text-code-function","post"],["text-code-punctuation","("],["text-code-function","url"],["text-code-punctuation",","],["text-code-function"," "],["","headers"],["text-code-punctuation","="],["text-code-function","headers"],["text-code-punctuation",","],["text-code-function"," "],["","json"],["text-code-punctuation","="],["text-code-function","payload"],["text-code-punctuation",")"],["","\nresponse"],["text-code-punctuation","."],["text-code-function","raise_for_status"],["text-code-punctuation","()"],["","\n"],["text-code-function","print"],["text-code-punctuation","("],["text-code-function","response"],["text-code-punctuation","."],["text-code-function","json"],["text-code-punctuation","())"]],"JavaScript":[["text-code-keyword","const"],[""," response "],["text-code-punctuation","="],[""," "],["text-code-keyword","await"],[""," "],["text-code-function","fetch"],["text-code-punctuation","('"],["text-code-string","https://api2.rhombussystems.com/api/robot/getAllMediaUris"],["text-code-punctuation","',"],[""," "],["text-code-punctuation","{"],["","\n  "],["text-code-property","method"],["text-code-punctuation",":"],[""," "],["text-code-punctuation","'"],["text-code-string","POST"],["text-code-punctuation","',"],["","\n  "],["text-code-property","headers"],["text-code-punctuation",":"],[""," "],["text-code-punctuation","{"],["","\n    "],["text-code-punctuation","'"],["text-code-string","x-auth-scheme"],["text-code-punctuation","':"],[""," "],["text-code-punctuation","'"],["text-code-string","api-token"],["text-code-punctuation","',"],["","\n    "],["text-code-punctuation","'"],["text-code-string","x-auth-apikey"],["text-code-punctuation","':"],[""," "],["text-code-punctuation","'"],["text-code-string","YOUR_API_KEY"],["text-code-punctuation","',"],["","\n    "],["text-code-punctuation","'"],["text-code-string","Content-Type"],["text-code-punctuation","':"],[""," "],["text-code-punctuation","'"],["text-code-string","application/json"],["text-code-punctuation","',"],["","\n  "],["text-code-punctuation","},"],["","\n  "],["text-code-property","body"],["text-code-punctuation",":"],[""," JSON"],["text-code-punctuation","."],["text-code-function","stringify"],["text-code-punctuation","({"],["","\n    "],["text-code-punctuation","\""],["text-code-string","deviceUuid"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","\""],["text-code-string","AAAAAAAAAAAAAAAAAAAAAA"],["text-code-punctuation","\""],["","\n  "],["text-code-punctuation","}),"],["","\n"],["text-code-punctuation","});"],["","\n"],["text-code-keyword","if"],[""," "],["text-code-punctuation","(!"],["","response"],["text-code-punctuation","."],["text-code-property","ok"],["text-code-punctuation",")"],[""," "],["text-code-keyword","throw"],[""," "],["text-code-keyword","new"],[""," "],["text-code-function","Error"],["text-code-punctuation","(`${"],["","response"],["text-code-punctuation","."],["text-code-property","status"],["text-code-punctuation","}"],["text-code-string",": "],["text-code-punctuation","${"],["text-code-keyword","await"],["text-code-string"," "],["","response"],["text-code-punctuation","."],["text-code-function","text"],["text-code-punctuation","()}`);"],["","\n\nconsole"],["text-code-punctuation","."],["text-code-function","log"],["text-code-punctuation","("],["text-code-keyword","await"],[""," response"],["text-code-punctuation","."],["text-code-function","json"],["text-code-punctuation","());"]],"Java":[["text-code-keyword","import"],[""," "],["text-code-keyword","java"],["text-code-punctuation","."],["text-code-keyword","net"],["text-code-punctuation","."],["text-code-keyword","URI"],["text-code-punctuation",";"],["","\n"],["text-code-keyword","import"],[""," "],["text-code-keyword","java"],["text-code-punctuation","."],["text-code-keyword","net"],["text-code-punctuation","."],["text-code-keyword","http"],["text-code-punctuation","."],["text-code-keyword","HttpClient"],["text-code-punctuation",";"],["","\n"],["text-code-keyword","import"],[""," "],["text-code-keyword","java"],["text-code-punctuation","."],["text-code-keyword","net"],["text-code-punctuation","."],["text-code-keyword","http"],["text-code-punctuation","."],["text-code-keyword","HttpRequest"],["text-code-punctuation",";"],["","\n"],["text-code-keyword","import"],[""," "],["text-code-keyword","java"],["text-code-punctuation","."],["text-code-keyword","net"],["text-code-punctuation","."],["text-code-keyword","http"],["text-code-punctuation","."],["text-code-keyword","HttpResponse"],["text-code-punctuation",";"],["","\n\n"],["text-code-keyword","public"],[""," "],["text-code-keyword","class"],[""," Example "],["text-code-punctuation","{"],["","\n    "],["text-code-keyword","public"],[""," "],["text-code-keyword","static"],[""," "],["text-code-keyword","void"],[""," "],["text-code-function","main"],["text-code-punctuation","("],["text-code-keyword","String"],["text-code-punctuation","[]"],[""," args"],["text-code-punctuation",")"],[""," "],["text-code-keyword","throws"],[""," "],["text-code-keyword","Exception"],[""," "],["text-code-punctuation","{"],["","\n        "],["text-code-keyword","String"],[""," body "],["text-code-punctuation","="],[""," "],["text-code-punctuation","\"\"\""],["","\n"],["text-code-string","            {"],["","\n"],["text-code-string","              \"deviceUuid\": \"AAAAAAAAAAAAAAAAAAAAAA\""],["","\n"],["text-code-string","            }"],["","\n"],["text-code-string","            "],["text-code-punctuation","\"\"\";"],["","\n        "],["text-code-keyword","HttpRequest"],[""," request "],["text-code-punctuation","="],[""," HttpRequest"],["text-code-punctuation","."],["text-code-function","newBuilder"],["text-code-punctuation","()"],["","\n            "],["text-code-punctuation","."],["text-code-function","uri"],["text-code-punctuation","("],["","URI"],["text-code-punctuation","."],["text-code-function","create"],["text-code-punctuation","(\""],["text-code-string","https://api2.rhombussystems.com/api/robot/getAllMediaUris"],["text-code-punctuation","\"))"],["","\n            "],["text-code-punctuation","."],["text-code-function","header"],["text-code-punctuation","(\""],["text-code-string","x-auth-scheme"],["text-code-punctuation","\","],[""," "],["text-code-punctuation","\""],["text-code-string","api-token"],["text-code-punctuation","\")"],["","\n            "],["text-code-punctuation","."],["text-code-function","header"],["text-code-punctuation","(\""],["text-code-string","x-auth-apikey"],["text-code-punctuation","\","],[""," "],["text-code-punctuation","\""],["text-code-string","YOUR_API_KEY"],["text-code-punctuation","\")"],["","\n            "],["text-code-punctuation","."],["text-code-function","header"],["text-code-punctuation","(\""],["text-code-string","Content-Type"],["text-code-punctuation","\","],[""," "],["text-code-punctuation","\""],["text-code-string","application/json"],["text-code-punctuation","\")"],["","\n            "],["text-code-punctuation","."],["text-code-function","method"],["text-code-punctuation","(\""],["text-code-string","POST"],["text-code-punctuation","\","],[""," HttpRequest"],["text-code-punctuation","."],["","BodyPublishers"],["text-code-punctuation","."],["text-code-function","ofString"],["text-code-punctuation","("],["","body"],["text-code-punctuation","))"],["","\n            "],["text-code-punctuation","."],["text-code-function","build"],["text-code-punctuation","();"],["","\n        "],["text-code-keyword","HttpResponse"],["text-code-punctuation","<"],["text-code-keyword","String"],["text-code-punctuation",">"],[""," response "],["text-code-punctuation","="],[""," HttpClient"],["text-code-punctuation","."],["text-code-function","newHttpClient"],["text-code-punctuation","()"],["","\n            "],["text-code-punctuation","."],["text-code-function","send"],["text-code-punctuation","("],["","request"],["text-code-punctuation",","],[""," HttpResponse"],["text-code-punctuation","."],["","BodyHandlers"],["text-code-punctuation","."],["text-code-function","ofString"],["text-code-punctuation","());"],["","\n        System"],["text-code-punctuation","."],["","out"],["text-code-punctuation","."],["text-code-function","println"],["text-code-punctuation","("],["","response"],["text-code-punctuation","."],["text-code-function","statusCode"],["text-code-punctuation","()"],[""," "],["text-code-punctuation","+"],[""," "],["text-code-punctuation","\""],["text-code-string"," "],["text-code-punctuation","\""],[""," "],["text-code-punctuation","+"],[""," response"],["text-code-punctuation","."],["text-code-function","body"],["text-code-punctuation","());"],["","\n    "],["text-code-punctuation","}"],["","\n"],["text-code-punctuation","}"]]},"responses":{"200":[["text-code-punctuation","{"],["","\n  "],["text-code-punctuation","\""],["text-code-property","audioFacetUris"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","{"],["","\n    "],["text-code-punctuation","\""],["text-code-property","<key>"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","{"],["","\n      "],["text-code-punctuation","\""],["text-code-property","lanLiveOpusUris"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","["],["","\n        "],["text-code-punctuation","\""],["text-code-string","<string>"],["text-code-punctuation","\""],["","\n      "],["text-code-punctuation","],"],["","\n      "],["text-code-punctuation","\""],["text-code-property","wanLiveOpusUri"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","\""],["text-code-string","<string>"],["text-code-punctuation","\""],["","\n    "],["text-code-punctuation","}"],["","\n  "],["text-code-punctuation","},"],["","\n  "],["text-code-punctuation","\""],["text-code-property","deviceUuid"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","\""],["text-code-string","AAAAAAAAAAAAAAAAAAAAAA"],["text-code-punctuation","\","],["","\n  "],["text-code-punctuation","\""],["text-code-property","lanCheckUrls"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","["],["","\n    "],["text-code-punctuation","\""],["text-code-string","<string>"],["text-code-punctuation","\""],["","\n  "],["text-code-punctuation","],"],["","\n  "],["text-code-punctuation","\""],["text-code-property","videoFacetUris"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","{"],["","\n    "],["text-code-punctuation","\""],["text-code-property","<key>"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","{"],["","\n      "],["text-code-punctuation","\""],["text-code-property","lanLiveH264Uris"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","["],["","\n        "],["text-code-punctuation","\""],["text-code-string","<string>"],["text-code-punctuation","\""],["","\n      "],["text-code-punctuation","],"],["","\n      "],["text-code-punctuation","\""],["text-code-property","lanLiveM3u8Uris"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","["],["","\n        "],["text-code-punctuation","\""],["text-code-string","<string>"],["text-code-punctuation","\""],["","\n      "],["text-code-punctuation","],"],["","\n      "],["text-code-punctuation","\""],["text-code-property","lanLiveMpdUris"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","["],["","\n        "],["text-code-punctuation","\""],["text-code-string","<string>"],["text-code-punctuation","\""],["","\n      "],["text-code-punctuation","],"],["","\n      "],["text-code-punctuation","\""],["text-code-property","lanVodM3u8UrisTemplates"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","["],["","\n        "],["text-code-punctuation","\""],["text-code-string","<string>"],["text-code-punctuation","\""],["","\n      "],["text-code-punctuation","],"],["","\n      "],["text-code-punctuation","\""],["text-code-property","lanVodMpdUrisTemplates"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","["],["","\n        "],["text-code-punctuation","\""],["text-code-string","<string>"],["text-code-punctuation","\""],["","\n      "],["text-code-punctuation","],"],["","\n      "],["text-code-punctuation","\""],["text-code-property","wanLiveH264Uri"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","\""],["text-code-string","<string>"],["text-code-punctuation","\","],["","\n      "],["text-code-punctuation","\""],["text-code-property","wanLiveM3u8Uri"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","\""],["text-code-string","<string>"],["text-code-punctuation","\","],["","\n      "],["text-code-punctuation","\""],["text-code-property","wanLiveMpdUri"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","\""],["text-code-string","<string>"],["text-code-punctuation","\","],["","\n      "],["text-code-punctuation","\""],["text-code-property","wanVodM3u8UriTemplate"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","\""],["text-code-string","<string>"],["text-code-punctuation","\","],["","\n      "],["text-code-punctuation","\""],["text-code-property","wanVodMpdUriTemplate"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","\""],["text-code-string","<string>"],["text-code-punctuation","\""],["","\n    "],["text-code-punctuation","}"],["","\n  "],["text-code-punctuation","},"],["","\n  "],["text-code-punctuation","\""],["text-code-property","wanLiveRobotUri"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","\""],["text-code-string","<string>"],["text-code-punctuation","\""],["","\n"],["text-code-punctuation","}"]]}}}