Aller au contenu
Livstick Développeurs

Redirect to the best user-facing page

Méthode GET https://client-api.v5.livstick.com/api/v3/containers/{crid}/redirect

Redirects to either recording or preview based on current container state. This operation is strictly read-only: an unknown CRID returns 404 and never creates a container. Create a container with the write-scoped POST /containers operation.

Autorisation

Scope requis containers:read

Use Authorization: Bearer liv_<prefix>_<secret>.

Paramètres

Nom Emplacement Type Requis Contraintes Description
crid Chemin string Requis Business reference of the container.

Réponses

302

Redirect to destination URL.

400 application/json Schéma ApiErrorEnvelope

Request rejected due to invalid payload or business precondition.

401 application/json Schéma ApiErrorEnvelope

Authentication failed or missing bearer token.

json 401
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing API key"
  }
}

403 application/json Schéma ApiErrorEnvelope

Authenticated but not allowed by scope or key constraints.

json 403
{
  "error": {
    "code": "FORBIDDEN",
    "message": "Insufficient permissions"
  }
}

404 application/json Schéma ApiErrorEnvelope

Target container could not be found.

json 404
{
  "error": {
    "code": "NOT_FOUND",
    "message": "Container not found for this CRID"
  }
}