# 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.

Como a reprodução é autorizada

Seu backend decide quem pode assistir. DRM-X fornece a autorização de reprodução. O player usa essa autorização para solicitar uma licença DRM.

- 01**Espectador**

Entra no seu serviço e solicita um vídeo.

- 02**Seu backend**

Verifica a compra, a assinatura ou outra permissão do usuário para assistir.

- 03**DRM-X**

Aplica as regras escolhidas e retorna a configuração e a autorização de reprodução.

- 04**Player**

Usa a autorização recebida para solicitar a licença DRM necessária para a reprodução.

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[#](#read-the-problem-response)

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[#](#playback_authentication_required)

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

Verifique as credenciais no servidor, o ambiente e a permissão license-tokens:create.



## playback_session_invalid[#](#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[#](#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[#](#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[#](#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[#](#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[#](#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[#](#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[#](#separate-api-failures-from-playback-failures)

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 ](https://docs.drm-x.com/pt/troubleshooting/playback) para identificar a primeira fase falhada.

<!-- Canonical: https://docs.drm-x.com/pt/api-reference/errors -->
<!-- Language: pt -->