GET Links

Overview

---

The following table contains information about the GET method in regards to the managing process, more precisely when you want to make a GET request that returns the links to the videos.

GET Links
Method	GET
URL or Endpoint	/api/projects/projectId/videos/id/stream
Headers	Authorization
Parameters	id, projectId
Body	Not Applicable

The description of the URL parameters is as follows:

URL Parameter Name	Mandatory	Type	Description
projectId	Yes	string	Unique Id of the project.
id	Yes	string	Unique id of the encoded video.

Request Body

The GET method doesn't contain a request body.

Response

{
  "success": true,
  "errors": ["string"],
  "messages": ["string"],
  "result": {
    "streams": [
      {
        "streamType": "string",
        "root": "string",
        "qualityTypes": [
          {
            "qualityType": "string",
            "streamUrl": "string",
            "statusDescription": "string"
          }
        ]
      }
    ]
  },
  "resultInfo": "string",
  "statusCode": 0
}

Information about the fields that appear when you receive the response are displayed in the table below.

Field Name	Type	Description
success	bool	If the response is successful it will return true. Otherwise will return false
errors	array[string]	Indicates if there was an error
messages	array[string]	Returns the response message from back-end
result	array[Object]	Returns the response object
streams	array[string]	Returns all streams
streamType	string	Returns the type of the stream
root	string	The unique name for the video being encoded
qualityTypes	array[string]	Returns all types of qualities
qualityType	string	Returns a specific quality type
streamUrl	string	URL of the stream
statusDescription	string	Description of the status
resultInfo	string	Returns extra information about the result
statusCode	integer($int32)	Returns the HTTP Status Code

If the action is successful, the service sends back an HTTP 200 or 201 response.

Errors

For information about the errors that are common to all actions, see Common Errors:

• HTTP Status Code 400: Bad Request

• HTTP Status Code 401: Unauthorized

• HTTP Status Code 403: Forbidden

• HTTP Status Code 404: Result Not Found

• HTTP Status Code 500: Internal Server Error

• HTTP Status Code 503: Backend Fetch Failed