Get review link details

Returns the details of a review link, including video information and configured permissions.

Behavior

  • Returns the video player URL for display
  • Includes the video name and link permission settings
  • Checks if the link is active and not expired
  • Expired or inactive links return a 403 error

Returned Permissions

FieldDescription
allow_commentWhether comments are enabled
allow_status_editWhether status changes (open/resolved) are allowed
show_resolvedWhether resolved comments are displayed
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

GET /public-video-review/{link_id}

Returns the details of a review link from the reviewer side. Used by the public review web app to render the player and enforce the link's permissions.

📘

Authentication: session token

The reviewer passes a token UUID as a query parameter. This token identifies the reviewer's session and is bound to any comment they create. To later edit/delete a comment, use the same token that was used on creation.

The token can be the same value as link_id or any client‑generated UUID.

HTTP Method & Path

GET /public-video-review/{link_id}?token=<uuid>

Base URL: https://api-v2.pandavideo.com.br

Path Parameters

NameTypeRequiredDescription
link_idstring (uuid)yesPublic review link UUID (the same id used in https://review.pandavideo.com/{link_id}).

Query Parameters

NameTypeRequiredDescription
tokenstring (uuid)yesReviewer session token.

Response

Success Response (200)

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "video_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "Client Review v1",
  "status": "active",
  "expires_at": "2025-01-25T23:59:59.000Z",
  "allow_comment": true,
  "allow_status_edit": true,
  "show_resolved": true,
  "video_url": "https://player-vz-abc123.tv.pandavideo.com.br/embed/?v=xyz789",
  "video_name": "Product Presentation Video"
}

Response Schema

FieldTypeDescription
idstring (uuid)Review link identifier.
video_idstring (uuid)Underlying video UUID.
namestringLink display name.
statusstringactive | expired.
expires_atstring (ISO date‑time)Expiration moment.
allow_commentbooleanIf false, create comment is blocked.
allow_status_editbooleanIf false, comment status changes are blocked.
show_resolvedbooleanIf false, the listing hides resolved comments.
video_urlstring (uri)Embeddable player URL.
video_namestringUnderlying video title.

Error Responses

  • 401 — missing/invalid token.
  • 403 — link is expired or inactive.
  • 404 — link not found.
  • 500 — internal error.

Example Usage

cURL

curl --request GET \
  --url 'https://api-v2.pandavideo.com.br/public-video-review/550e8400-e29b-41d4-a716-446655440000?token=550e8400-e29b-41d4-a716-446655440000'

Recipes

Path Params
Query Params
Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json