Ir al contenido
Abre CastalyConsola

Características de la plataforma

Conmutación por error entre grupos

Asigne a una clave ordinaria un grupo primario y una lista ordenada de grupos alternativos.

Un grupo de enrutamiento es un conjunto de canales de proveedores de servicios. Una clave API normal nombra un grupo primario y, opcionalmente, grupos alternativos en orden de prioridad. Cuando el grupo principal no puede atender una solicitud, la puerta de enlace continúa en esa lista en lugar de devolver un error a su cliente.

Configura la cadena en Claves API cuando creas o editas una clave. El orden es importante y la consola te permite mover las entradas hacia arriba y hacia abajo.

Grupo primario

El grupo nombrado en la clave.

Prioridades del canal en su interior

Cada prioridad del grupo se prueba antes que el siguiente grupo.

Próximo grupo de reserva

Un cambio de ruta, no otro reintento del mismo proveedor de servicios.

Facturado por el grupo que atendió

El grupo resuelto se registra en el registro de consumo.

La conmutación por error cubre únicamente problemas de ruta y conexión; un error del cliente detiene la solicitud inmediatamente.
  • El grupo no tiene canal para el modelo solicitado.
  • El grupo está en su límite de tarifa para su cuenta.
  • Se probaron todas las prioridades de canal dentro del grupo y aún así se devolvió un error reintentable.

Un grupo agota sus propias prioridades de canal antes de que se pruebe el siguiente grupo, por lo que un respaldo es un cambio de ruta, no un reintento adicional del mismo proveedor de servicios.

La conmutación por error cubre únicamente problemas de ruta y conexión. La solicitud se detiene inmediatamente en:

  • errores del cliente: JSON con formato incorrecto, parámetro no válido, longitud del contexto excedida;
  • una conexión de cliente cancelada;
  • una solicitud fijada a un canal específico;
  • una respuesta transmitida que ya envió bytes de cuerpo real a su cliente. Los latidos del corazón por sí solos no cierran la puerta, pero una vez que se ha escrito el contenido, la solicitud nunca se reproduce en otra ruta.

Luego de un cambio, la solicitud se factura con el multiplicador del grupo que la atendió, no del grupo primario. El grupo que atendió queda registrado en el registro de consumo.

Los grupos de campaña requieren un respaldo

Sección titulada «Los grupos de campaña requieren un respaldo»

Las rutas de tiempo limitado son temporales por diseño. Cuando el grupo principal de una clave es una ruta de campaña, guardar la clave requiere al menos un grupo alternativo concreto, por lo que la clave sigue funcionando una vez que finaliza esa ruta.

Una Clave API inteligente ya recorre cada grupo que su cuenta puede usar, ordenados por su estrategia de enrutamiento, por lo que no requiere una lista alternativa manual.