Rest Api Aktion

Rest Api Aktion Symbol

Behandelt RESTful-API-Aufrufe asynchron, um hohe Lasten besser verarbeiten zu können. Diese Aktion ermöglicht es dem System, höhere Lasten zu verarbeiten, da kein blockierender Thread erforderlich ist (derzeit werden REST API-Aktionsaufrufe mit einer Snippet-Aktion ausgeführt, die einen blockierenden Thread erfordert). Die Aktion gibt sowohl den Text als auch die Kopfzeilen für den API-Aufruf zurück. Dies erleichtert Tests und Fehlerbehebung von Skripten.

Antwort-Kopfzeilen wurden zur Rückgabe ab CXone Version Herbst 2022 hinzugefügt. Um die Antwort-Kopfzeile zu sehen, müssen Sie alle Skripte, die die REST API-Aktion enthalten, speichern, sodass die Snippet-Aktion die Änderung beinhaltet.

Properties

Eigenschaft Details
Verb

Unterstützt grundlegende REST-Aktionen wie GET, PUT, POST, DELETE und PATCH.

Parameter

Unterstützt die Möglichkeit, Abfrageparameter anzugeben oder Daten zu veröffentlichen. Jede Art von JSON - Jobject, Jarray, Jtoken sollte akzeptabel sein. Derzeit erfordert die Aktion, dass JSON in einer einzigen Zeile bereitgestellt wird. Variablensubstitution von einem String, der JSON enthält, oder Konvertieren des dynamischen Datentyps in JSON mit Hilfe von .asjson()-Methode wird unterstützt. Sie können auch die Ausgabevariable resultSet(out) von einer früheren REST API-Aktion zu dieser Eigenschaft weitergeben.

Kopfzeilen

Unterstützt die Möglichkeit, benutzerdefinierte Kopfzeilen hinzuzufügen, um die Kundenauthentifizierung zu ermöglichen (z. B. Bearertoken). Im JSON-Format ausgedrückte Schlüsselwertpaare werden akzeptiert. Für diese Aktion muss JSON in einer einzelnen Zeile bereitgestellt werden. Variablensubstitution von einer Zeichenfolge, die JSON enthält, oder Konvertieren des dynamischen Datentyps in JSON mithilfe von .asjson() Methode wird unterstützt. Sie können aber auch die Ausgabevariable resultSet(out) von der vorherigen REST API-Aktion an diese Eigenschaft übergeben.

Wichtig Wenn für Ihren benutzerdefinierten URL-Endpunkt unterschiedliche Header erforderlich sind, muss er in dieser Eigenschaft angegeben werden. Um die Funktionsparität mit der vorhandenen Snippet-Aktion zu behalten, fügt CXone die folgenden Kopfzeilen hinzu.

{"Accept":"application/json", "Content-Type" :"application/x-www-form-urlencoded"}

Befehl

Einzige Option ist MakeRestRequest, die bei Verwendung in einer Snippet -Aktion gleich funktioniert. Zukünftige Entwicklungen können zusätzliche Befehle bieten, die die Snippet-Aktion bietet.

TimeOutInMilliSeconds

Ermöglicht die Angabe und Berücksichtigung eines Timeouts des REST-Aufrufs. Muss kleiner als 90 Sekunden (90.000 Millisekunden) sein.

Serviceadresse

Ermöglicht die Angabe einer benutzerdefinierten URL, einschließlich der Möglichkeit, Abfrageparameter für ein GET anzugeben. Die variable Substitution wird ebenfalls unterstützt.

Ausgabevariablen

Variabel Details
resultSet(out)

Antwort vom angegebenen Endpunkt Ihrer Organisation in der Serviceadresse. In dem Studio Trace-Fenster erscheint es als Dynamisches Objekt zu Anzeigezwecken. Sie können dieses resultSet auch wie es ist an die Kopfzeile mit Parametern weitergeben.

errorArgList(out)

Fehlerbedingungen haben aus Kompatibilitätsgründen ein Objekt wie der REST-Proxy. Unterstützt den DynamicData-Typ.

Verzweigungen

Verzweigung Details
OnThrottle

Genommener Pfad, wenn zu viele Anforderungen innerhalb kurzer Zeit ausgeführt werden. Weitere Informationen finden Sie in den folgenden Einschränkungen.

OnInvalidInput

Genommener Pfad, wenn eine ungültige Eingabe gefunden wird oder ein Timeout-Fehler auftritt. Jeder Parameter wird beim Speichern des Skripts überprüft.

OnFailure

Genommener Pfad, wenn ein Fehler oder eine Ausnahme innerhalb der NICE CXone auftritt, die die Anforderung ausführt.Anwendung

OnError

Genommener Pfad, wenn der Remote-Kundenendpunkt einen http-Fehlercode zurückgibt.

Default

Genommener Pfad, wenn die Antwort nicht innerhalb von 90 Sekunden empfangen wird.

Einschränkungen

Einschränkungen werden auf Ebene von Business UnitGeschlossen Eine übergeordnete organisatorische Gruppierung, die Sie für die technische Unterstützung und Abrechnung und außerdem zur Bearbeitung von globalen Einstellungen in Ihrer CXone Umgebung einsetzen können. auferlegt, sodass einer den anderen nicht beeinflussen sollte. Nachfolgend finden Sie die Einschränkungen innerhalb der Plattform:

  • Antwortformat – Nur das JSON-Antwortformat wird unterstützt.
  • Neuversuche bei Fehler – Der Aktionshandler versucht es automatisch zweimal, wenn eine Fehlermeldung empfangen wird, bevor die Antwort zurückgegeben wird. Jeder beliebige HTTP-Statuscode außer 2xx kann erneut versucht werden.
  • Zeitüberschreitung – Sie geben den Zeitüberschreitungswert in der Anfrage an. Der Wert kann nicht mehr als 90 Sekunden betragen.
  • Max. Antwortgröße – Die maximale Antwortgröße beträgt 32 KB. Dies entspricht der bestehenden Snippet-Funktion.
  • Drosselungsgrenzwert – Der Drosselungsgrenzwert wird durch zwei Parameter definiert:
    • Max. gleichzeitige Anfragen – Standardmäßig sind bis zu 100 gleichzeitige Anfragen erlaubt. Dieser Grenzwert ist für alle CXone Kunden gleich und entspricht der bestehenden Snippet-Funktion. Diese Aktion erzeugt jedoch asynchrone Anrufe. Dies bedeutet, dass 100 gleichzeitige Anfragen zu einem viel höheren Durchsatz führen als die bestehende Snippet-Funktion. Wenn Sie mehr als 100 gleichzeitige Anfragen benötigen, sprechen Sie mit Ihrem CXone Account Representative über die Erhöhung des Grenzwerts für Ihre Geschäftseinheit. Es sind Sondergenehmigungen erforderlich.
    • Anzahl in Warteschleife – Wenn Anfragen den Grenzwert übersteigen, gehen weitere Anfragen in eine Verarbeitungswarteschleife. Sobald Anfragen unter den Grenzwert sinken, werden Anfragen in der Warteschleife wieder verarbeitet. Das System stellt bis zu 5.000 Anfragen in die Warteschleife.
  • Sicherung – Wenn Ihre angegebene URL ausgefallen oder nicht erreichbar ist, können Sie zu viele Fehler bei Ihren Anfragen erhalten. CXone sichert (d. h. verringert) die Anfrageausführung für einen gewissen Zeitraum. So kann Ihre angegebene URL aus dem Fehlerzustand wiederhergestellt werden. Die Grenzwerte sind unten angegeben.
    • Back-Off-Zeit oder Pausenzeit – Wenn die Ausfallrate erreicht ist, werden 30 Sekunden lang keine Anfragen mehr ausgeführt.
    • Mindestdurchsatz – 100 Anfragen pro Sekunde. Wenn Ihre Geschäftseinheit die Mindestanzahl an Anfragen nicht ausführt, werden Ihre Anfragen weiter ausgeführt, obwohl die Anfragen fehlschlagen.
    • Fehlerrate – Wenn 50 % der Anfragen innerhalb von 30 Sekunden fehlschlagen, werden Ihre Anfragen in den folgenden 30 Sekunden nicht ausgeführt. 30 Sekunden ist ein rollendes Fenster.

Andere Optionen

Sie können externe RESTful API-Anfragen ersetzen, die derzeit in der Snippet-Aktion ausgeführt werden.