List URL paths

post https://app.mk.io/api/v1/projects/:project_name/media/streamingLocators/:locator_name/listPaths

ListPaths returns the set of valid streaming paths for a given Streaming Locator. A distinct set of paths is returned for each type of DRM configured, per the 'EnabledProtocols' property of the streaming policy.

RBAC Capability Required: ams.streaminglocator.create

Authentication

Authorization Bearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

• project_name (string, Required)
• locator_name (string, Required)

Request

This endpoint expects an object.

• urlStyle (enum, Optional) : Defaults to AMS. The style of URL associated to the streaming endpoint. Default is 'AMS'.
  Allowed values: AMS, Aquila, Unified

Response

• 200 Streaming locator paths returned.
  • downloadPaths (list of strings, Required): The download paths for the locator.
  • drm (map from strings to object StreamingLocatorDrm, Required): The license acquisition URLs for configured DRM types.
    • certificateUrl (string, Optional): The URL for obtaining the streaming certificate.
    • licenseAcquisitionUrl (string, Required): The license acquisition URL for the DRM.
  • streamingPaths (list of objects StreamingLocatorListPathsStreamingPaths, Required): The streaming paths for the locator.
    • encryptionScheme (enum, Required): The encryption scheme used for the path.
      Allowed values: NoEncryption, EnvelopeEncryption, CommonEncryptionCenc, CommonEncryptionCbcs
    • paths (list of strings, Required): The paths for the locator.
    • streamingProtocol (enum, Required): The streaming protocol used for the path.
      Allowed values: Hls, Dash, Download, SmoothStreaming

Errors

• 400 Bad Request

  • error (object ErrorDetail, Required): Pertinent information about the error.
    • code (string, Required): The error code.
    • detail (string, Required): The error message.
    • extraDetail (map from strings to any, Optional): Extra information regarding this error.
    • ref (string, Required): A reference to the request that caused the error.
    • status (integer, Required): The HTTP status code.

• 401 Unauthorized

  • Same structure as above.

• 403 Forbidden

  • Same structure as above.

• 404 Not Found

  • Same structure as above.

• 429 Too Many Requests

  • Same structure as above.

• 500 Internal Server Error

  • Same structure as above.