Pular para o conteúdo
Abra CastalyConsola

Recursos da plataforma

Failover entre grupos

Dê a uma chave comum um grupo primário e uma lista ordenada de grupos substitutos.

Um grupo de roteamento é um conjunto de canais de provedores de serviços. Uma chave de API comum nomeia um grupo primário e, opcionalmente, grupos substitutos em ordem de prioridade. Quando o grupo primário não consegue atender a uma solicitação, o gateway continua nessa lista em vez de retornar um erro ao seu cliente.

Configure a cadeia em Chaves de API ao criar ou editar uma chave. A ordem é importante e o console permite mover as entradas para cima e para baixo.

Grupo primário

O grupo nomeado na chave.

Prioridades do canal dentro dele

Cada prioridade do grupo é tentada antes do próximo grupo.

Próximo grupo substituto

Uma mudança de rota, não outra nova tentativa do mesmo provedor de serviços.

Faturado pelo grupo que atendeu

O grupo resolvido é registrado no log de consumo.

O failover cobre apenas problemas de rota e conexão; um erro do cliente interrompe a solicitação imediatamente.

Quando a solicitação passa para o próximo grupo

Seção intitulada “Quando a solicitação passa para o próximo grupo”
  • O grupo não possui canal para o modelo solicitado.
  • O grupo atingiu o limite de taxa da sua conta.
  • Cada prioridade de canal dentro do grupo foi tentada e ainda retornou um erro repetível.

Um grupo esgota suas próprias prioridades de canal antes que o próximo grupo seja tentado, portanto, um fallback é uma mudança de rota, não uma nova tentativa extra do mesmo provedor de serviços.

O failover cobre apenas problemas de rota e conexão. A solicitação é interrompida imediatamente em:

  • erros do cliente — JSON malformado, um parâmetro inválido, comprimento do contexto excedido;
  • uma conexão de cliente cancelada;
  • uma solicitação fixada em um canal específico;
  • uma resposta transmitida que já enviou bytes reais do corpo ao seu cliente. As pulsações por si só não fecham a porta, mas uma vez escrito o conteúdo, a solicitação nunca é reproduzida em outra rota.

Após uma troca, a solicitação é cobrada com o multiplicador do grupo que a atendeu e não do grupo primário. O grupo atendido é registrado no log de consumo.

As rotas por tempo limitado são temporárias por definição. Quando o grupo primário de uma chave é uma rota de campanha, salvar a chave requer pelo menos um grupo substituto concreto, para que a chave continue funcionando quando a rota terminar.

Uma chave de API inteligente já percorre todos os grupos que sua conta pode usar, ordenada por sua estratégia de roteamento, portanto, não é necessária uma lista de substitutos manual.