Aller au contenu
Ouvrir CastalyConsole

Fonctionnalités de la plateforme

Basculement entre groupes

Donnez à une clé ordinaire un groupe principal et une liste ordonnée de groupes de secours.

Un groupe de routage est un ensemble de canaux de fournisseur de services. Une clé API ordinaire nomme un groupe principal et, éventuellement, des groupes de secours par ordre de priorité. Lorsque le groupe principal ne peut pas répondre à une demande, la passerelle continue dans cette liste au lieu de renvoyer une erreur à votre client.

Configurez la chaîne dans API Keys lorsque vous créez ou modifiez une clé. L’ordre est important et la console vous permet de déplacer les entrées de haut en bas.

Groupe principal

Le groupe nommé sur la clé.

Priorités des chaînes à l'intérieur

Chaque priorité du groupe est essayée avant le groupe suivant.

Groupe de secours suivant

Un changement d'itinéraire, pas une autre tentative du même fournisseur de services.

Facturé par le groupe qui a servi

Le groupe résolu est enregistré dans le journal de consommation.

Le basculement couvre uniquement les problèmes de route et de connexion ; une erreur client arrête immédiatement la demande.
  • Le groupe n’a pas de canal pour le modèle demandé.
  • Le groupe a atteint sa limite de tarif pour votre compte.
  • Chaque priorité de canal au sein du groupe a été essayée et a toujours renvoyé une erreur réessayable.

Un groupe épuise ses propres priorités de canal avant que le groupe suivant ne soit essayé, donc un repli est un changement de route, pas une nouvelle tentative supplémentaire du même fournisseur de services.

Le basculement couvre uniquement les problèmes de routage et de connexion. La demande s’arrête immédiatement :

  • – JSON mal formé, paramètre non valide, longueur de contexte dépassée ;
  • une connexion client annulée ;
  • une requête épinglée sur un canal spécifique ;
  • une réponse diffusée en continu qui a déjà envoyé des octets de corps réel à votre client. Les battements de cœur à eux seuls ne ferment pas la porte, mais une fois le contenu écrit, la requête n’est jamais relue sur un autre itinéraire.

Après un changement, la demande est facturée avec le multiplicateur du groupe qui l’a servie, et non du groupe principal. Le groupe qui a servi est enregistré dans le journal de consommation.

Les groupes de campagnes nécessitent une solution de secours

Section intitulée « Les groupes de campagnes nécessitent une solution de secours »

Les itinéraires à durée limitée sont temporaires de par leur conception. Lorsque le groupe principal d’une clé est une route de campagne, l’enregistrement de la clé nécessite au moins un groupe de secours concret, de sorte que la clé continue de fonctionner une fois cette route terminée.

Une Smart API Key parcourt déjà tous les groupes que votre compte peut utiliser, classés par sa stratégie de routage, elle ne nécessite donc pas de liste de secours manuelle.