Get a playback ID | FastPix Developer Documentation

{
  "success": true,
  "data": {
    "id": "54fd5e7e-3aa5-4817-b56d-44932f67f6c3",
    "accessPolicy": "public",
    "accessRestrictions": {
      "domains": {
        "defaultPolicy": "allow",
        "allow": [
          "example.com",
          "trustedsite.org"
        ],
        "deny": [
          "malicioussite.io",
          "abc.net"
        ]
      },
      "userAgents": {
        "defaultPolicy": "deny",
        "allow": [
          "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Mobile Safari/537.36"
        ],
        "deny": [
          "PostmanRuntime/7.29.0"
        ]
      }
    }
  }
}

This endpoint retrieves details about a specific playback ID associated with a media asset. Use it to check the access policy for that specific playback ID, such as whether it is public or private.

How it works:

Make a GET request to the endpoint, replacing {mediaId} with the media ID and {playbackId} with the playback ID.
This request is useful for auditing or validation before granting playback access in your application.

Example: A media platform might use this endpoint to verify if a playback ID is public or private before embedding the video in a frontend player or allowing access to a restricted group.

This endpoint retrieves details about a specific playback ID associated with a media asset. Use it to check the access policy for that specific playback ID, such as whether it is public or private. **How it works:** 1. Make a GET request to the endpoint, replacing `{mediaId}` with the media ID and `{playbackId}` with the playback ID. 2. This request is useful for auditing or validation before granting playback access in your application. **Example:** A media platform might use this endpoint to verify if a playback ID is public or private before embedding the video in a frontend player or allowing access to a restricted group.

Authentication

AuthorizationBasic

FastPix APIs are secured with Basic Authentication. Use your Access Token ID as the username and Secret Key as the password in the Authorization header of each API request.

Username: Access Token ID
Password: Secret Key

Activate your FastPix account to generate your API credentials. See the guide here

FastPix APIs are secured with Basic Authentication. Use your Access Token ID as the username and Secret Key as the password in the Authorization header of each API request. - <b>Username:</b> Access Token ID - <b>Password:</b> Secret Key Activate your FastPix account to generate your API credentials. <a href="https://docs.fastpix.io/docs/activate-account" target="_blank">See the guide here</a>

Path parameters

mediaIdstringRequiredformat: "uuid"

playbackIdstringRequiredformat: "uuid"

Response

Successfully retrieved playback ID details

successboolean

Shows the request status. Returns true for success and false for failure.

dataobject

$	curl https://api.fastpix.com/v1/on-demand/4fa85f64-5717-4562-b3fc-2c963f66afa6/playback-ids/4fa85f64-5717-4562-b3fc-2c963f66afa6 \
>	-u "<username>:<password>"