GET Remote Video¶
-
GET
/remotes/
(sid)/videos/
(vsid)¶ Uses an existing remote session to retrieve a remote video. The session must have been created successfully using
POST /remotes
and video creation must have been started usingPOST /remotes/(sid)/videos
. The caller should not attempt retrieving a video until a call toGET /remotes/(sid)/videos/(vsid)/status
indicates that video creation is complete. The returned file may be optionally cached on the server and retrieved usingGET /projects/(pid)/cache/(key)
.Parameters: - sid (string) – Unique remote session identifier.
- vsid (string) – Unique video creation session identifier.
Query Parameters: - cache – Optional cache identifier. Set to project to store the retrieved video in a project cache.
- project – Project identifier. Required when cache is set to project.
- key – Cached object key. Must be specified when cache is set to project.
Status Codes: - 200 OK – The video has been returned in the response body.
- 206 Partial Content – A portion of the video has been returned in the response body.
- 400 Bad Request – “Agent required” This call requires a remote agent, but the current session isn’t running an agent.
- 404 Not Found – The session doesn’t exist or has timed-out.
Response Headers: - Content-Type – video/mp4 or video/webm, depending on the original
POST /remotes/(sid)/videos
request. - X-Slycat-Message – For errors, contains a human-readable description of the problem.
- X-Slycat-Hint – For errors, contains an optional description of how to fix the problem.
Sample Request
GET /remotes/505d0e463d5ed4a32bb6b0fe9a000d36/videos/431d0e463d5ed4a32bb6b0fe9a000a37