DRM-X 6.0 logo de pomba e ramo de oliveiraDRM-X 6.0Documentação
◎ Português

Referência de erros de sessão de reprodução

Identifique os erros da sessão de reprodução API, entenda o status HTTP e solicite IDs e escolha uma ação de recuperação segura.

Ver MarkdownExemplos onlineAtualizado em 2026-09-05
Sua infraestrutura decide o acesso; DRM-X aplica a política assinada. Mídia criptografada e licenças DRM seguem caminhos de entrega separados.
Sua infraestrutura decide o acesso; DRM-X aplica a política assinada. Mídia criptografada e licenças DRM seguem caminhos de entrega separados.

Leia a resposta do problema#

Os erros de sessão de reprodução incluem um status HTTP mais o legível por máquina code, requestId, retryable e contractVersion. Falhas de validação também identificam erros de campo. Grave o pedido ID e o estágio falhou sem registrar credenciais, DRM License Tokens, desafios ou bytes de licença.

{
  "status": 400,
  "code": "playback_session_invalid",
  "title": "The playback session request is invalid.",
  "requestId": "your-request-correlation-id",
  "retryable": false,
  "contractVersion": 1
}

Este é um excerto de erro ilustrativo. As respostas reais podem incluir um problema type, detail e errors específicos do campo.

playback_authentication_required#

HTTP 401. O projeto API cliente está faltando ou não é válido para este pedido.

Verifique o lado do servidor credenciais, o ambiente e as unidades de licença:criar o escopo.

playback_session_invalid#

HTTP 400. Um ou mais campos de solicitação falham na validação.

Leia os erros, corrija os campos nomeados e combine a política com o pacote publicado.

playback_environment_not_found#

HTTP 404. Não foi possível encontrar o ambiente de reprodução.

Use o ambiente pretendido UUID com o seu próprio credenciais.

playback_content_not_found#

HTTP 404. Nenhum pacote publicado e conjunto de chaves ativa correspondem a esta solicitação.

Verifique o confiável Content ID, ambiente, estado publicado e conjunto de chaves ativa.

playback_manifest_not_found#

HTTP 404. O manifesto registrado requerido não está disponível.

Verifique se a saída publicada contém o tipo manifesto requerido para este DRM.

playback_blocked#

HTTP 403. Um ativo DRM-X A regra da lista negra bloqueia a reprodução.

Reveja a regra de acesso aplicável. Não tente novamente ou ignore- a do reprodutor.

concurrent_stream_limit_reached#

HTTP 403. O limite de fluxo simultâneo foi alcançado.

Release sessões terminadas ou abandonadas e aplique sua política de acesso à conta.

playback_session_rate_limited#

HTTP 429. O limite da taxa de avaliação da sessão foi atingido.

Respeite Retry-After quando fornecido. Evite requisições de sessão duplicadas e use backoff limitado.

Separar as falhas API das falhas de reprodução#

Uma resposta de sessão bem-sucedida não prova que suporte de mídia, codecs, DRM dispositivo ou proteção de saída estão prontos. Use a matriz Failure-stage para identificar a primeira fase falhada.