Zum Inhalt springen
Öffne CastalyKonsole

Plattformfunktionen

Failover zwischen Gruppen

Geben Sie einem gewöhnlichen Schlüssel eine Primärgruppe und eine geordnete Liste von Fallback-Gruppen.

Eine Routinggruppe ist eine Reihe von Dienstanbieterkanälen. Ein gewöhnlicher API-Schlüssel benennt eine primäre Gruppe und optional Fallbackgruppen in der Reihenfolge ihrer Priorität. Wenn die primäre Gruppe eine Anfrage nicht bedienen kann, fährt das Gateway in dieser Liste fort, anstatt einen Fehler an Ihren Client zurückzugeben.

Konfigurieren Sie die Kette in API-Schlüssel, wenn Sie einen Schlüssel erstellen oder bearbeiten. Die Reihenfolge ist wichtig, und mit der Konsole können Sie Einträge nach oben und unten verschieben.

Primärgruppe

Die auf dem Schlüssel genannte Gruppe.

Kanalprioritäten darin

Jede Priorität in der Gruppe wird vor der nächsten Gruppe ausprobiert.

Nächste Fallback-Gruppe

Eine Routenänderung, kein erneuter Versuch desselben Dienstanbieters.

Wird von der Gruppe in Rechnung gestellt, die bedient hat

Die aufgelöste Gruppe wird im Verbrauchsprotokoll aufgezeichnet.

Failover deckt nur Routen- und Verbindungsprobleme ab; Ein Clientfehler stoppt die Anfrage sofort.
  • Die Gruppe hat keinen Kanal für das angeforderte Modell.
  • Die Gruppe hat ihr Ratenlimit für Ihr Konto erreicht.
  • Jede Kanalpriorität innerhalb der Gruppe wurde ausprobiert und es wurde trotzdem ein wiederholbarer Fehler zurückgegeben.

Eine Gruppe erschöpft ihre eigenen Kanalprioritäten, bevor die nächste Gruppe versucht wird. Ein Fallback ist also eine Routenänderung und kein zusätzlicher erneuter Versuch desselben Dienstanbieters.

Failover deckt nur Routen- und Verbindungsprobleme ab. Die Anfrage stoppt sofort am:

  • Clientfehler – fehlerhaftes JSON, ein ungültiger Parameter, Kontextlänge überschritten;
  • eine abgebrochene Client-Verbindung;
  • eine Anfrage, die an einen bestimmten Kanal angeheftet ist;
  • eine gestreamte Antwort, die bereits echte Body-Bytes an Ihren Client gesendet hat. Heartbeats allein schließen die Tür nicht, aber sobald der Inhalt geschrieben wurde, wird die Anfrage nie auf einer anderen Route wiederholt.

Nach einem Wechsel wird die Anfrage mit dem Multiplikator der Gruppe abgerechnet, die sie bedient hat, nicht mit dem Multiplikator der primären Gruppe. Die Gruppe, die bedient hat, wird im Verbrauchsprotokoll aufgezeichnet.

Zeitlich begrenzte Routen sind von Natur aus temporär. Wenn die primäre Gruppe eines Schlüssels eine Kampagnenroute ist, erfordert das Speichern des Schlüssels mindestens eine konkrete Fallback-Gruppe, sodass der Schlüssel weiterhin funktioniert, sobald diese Route endet.

Ein Smart API Key durchläuft bereits jede Gruppe, die Ihr Konto verwenden kann, geordnet nach ihrer Routing-Strategie, sodass keine manuelle Fallback-Liste erforderlich ist.