DocumentaçãoAdobe PassMonitoramento de simultaneidade do Adobe Pass

Tratamento de erros de conflito 409 handling-409-errors

Last update: Thu Nov 20 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Quando um usuário tenta iniciar um novo fluxo e atinge um limite de uso simultâneo, o Monitoramento de Simultaneidade retorna uma resposta de 409 Conflito. Entender como lidar com esse erro é fundamental para fornecer uma boa experiência ao usuário.

O que é um conflito 409? what-is-a-409-conflict

Um conflito 409 ocorre quando:

  1. O usuário tenta iniciar um novo fluxo
  2. A avaliação da política determina que a solicitação excederia os limites
  3. O sistema retorna 409 com informações detalhadas sobre conflito
  4. O aplicativo deve decidir como lidar com o conflito

Estrutura de resposta 409

{
  "status": "error",
  "error": {
    "code": "POLICY_VIOLATION",
    "message": "Concurrent usage limit exceeded"
  },
  "evaluationResult": {
    "decision": "DENY",
    "associatedAdvice": [
      {
        "id": "advice-1",
        "adviceType": "rule-violation",
        "attributes": {
          "rule": "max_streams",
          "threshold": 3,
          "current": 4,
          "conflicts": [
            {
              "sessionId": "session-123",
              "terminationCode": "term-456",
              "metadata": {
                "deviceId": "device-789",
                "channel": "Channel1",
                "contentType": "live"
              }
            }
          ]
        }
      }
    ]
  }
}

Noções básicas da resposta do understanding-the-response

Campos-chave

  • decision: Sempre "NEGAR" para conflitos 409
  • associatedAdvice: Matriz de objetos de aviso explicando a violação
  • conflicts: Lista de sessões ativas que estão causando o conflito
  • terminationCode: Código exclusivo para encerrar uma sessão específica

Tipos de Dicas

Dica de violação de regra

{
  "adviceType": "rule-violation",
  "attributes": {
    "rule": "max_streams",
    "threshold": 3,
    "current": 4,
    "conflicts": [...]
  }
}

Dica de Término Remoto

{
  "adviceType": "remote-termination",
  "attributes": {
    "terminatedBy": "session-456",
    "reason": "New session requested with X-Terminate header"
  }
}

Estratégias de manuseio handling-strategies

  • No modo FIFO, o CM permite que a nova sessão seja iniciada encerrando uma existente.
  • No modo LIFO, o CM bloqueia a nova sessão e informa ao usuário

Práticas recomendadas best-practices

​1. Comunicação clara com o utilizador

  • Explicar o limite - Os usuários devem entender por que estão bloqueados
  • Mostrar opções disponíveis - O que eles podem fazer para resolver o conflito
  • Fornecer contexto - Mostrar quais sessões estão ativas

​2. Tratamento de erros adequado

  • Não travar - Manipular erros 409 normalmente
  • Fornecer alternativas - Oferecer maneiras de resolver o conflito
  • Salvar estado do usuário - Não perca a seleção de conteúdo

​3. Considerações sobre a experiência do usuário

  • Resolução rápida - Facilitar a resolução de conflitos
  • Limpar opções - Os usuários devem entender suas opções
  • Comportamento consistente - Sempre tratar conflitos da mesma forma

​4. Considerações técnicas

  • Analisar a resposta com cuidado - Extrair todas as informações relevantes
  • Tratar casos de borda - E se nenhum conflito for retornado?
  • Registrar conflitos - Rastrear violações de política para análise
recommendation-more-help
42139a1e-84f9-43e7-9581-d6e1d65973da