So testen Sie einen verknüpften Prozess
Sobald der verknüpfte Prozess erstellt wurde, ist es Zeit, den Prozess zu testen. Beim Testen von API-verknüpften Prozessen können wir mehrere Methoden verwenden. Die erste und einfachste Methode besteht darin, dem Prozess einen manuellen Trigger hinzuzufügen und ihn mit diesem auszuführen. Dies ist möglich, wenn der API-Trigger eine Nutzlast im HTTP-Text erwartet. In diesem Fall muss der Test jedoch auf andere Weise durchgeführt werden, wenn wir den benötigten Wert in der URL als Abfrageparameter haben. Benennen Sie den Parameter des manuellen Triggers unbedingt als „httpBody“. Dadurch können Sie die Referenz verwenden#trigger.data.httpBody
unabhängig vom Auslöser.
Zum Testen verknüpfter Prozesse können Sie ein Drittanbietertool wie Postman verwenden, um eine HTTP-Anforderung an den Endpunkt zu senden. Die Basis-URL hängt von der Agentengruppe ab, in der der verknüpfte Prozess und die API bereitgestellt wurden. Sie können die Basis-URL auf der Einstellungsseite des Agenten überprüfen. Bei PaaS-Agenten ist die Basis-URL normalerweise wie folgt festgelegt:
https://{agent-name}.frendsapp.com:443/
http://{agent-name}.frendsapp.com:80/
Wie Sie sehen, gibt es spezifische Basis-URLs für HTTP- und HTTPS-Aufrufe. Sie müssen prüfen, welches HTTP-Protokoll in der API-Spezifikation und im verknüpften Prozess aktiviert ist.
Frends bietet nicht viele weitere Tools zum Testen der API-Prozesse oder der gesamten API-Struktur, aber zum Glück gibt es eine Vielzahl von API-Testtools und Dienstanbietern von Drittanbietern, die Ihnen Testfunktionen für Ihre API anbieten können. Hier sind einige Beispiele, die Sie verwenden können:
SmartBear
ACCELQ
Debuggen verschiedener API-Fehler
Fehler sind Teil jedes Entwicklungsprozesses, auch bei der Implementierung von Frends API-Endpunkten. Jeder macht Fehler und das ist normalerweise gut, weil es jedem hilft, sich weiterzuentwickeln. Bei der Implementierung von Frends API-Endpunkten passieren zwangsläufig einige Fehler. In diesem Modul werden wir uns einige der häufigsten Fehler ansehen und wie man sie in Frends behebt.
Status 400 Ungültige Anfrage
Ein häufigster Fehler bezieht sich auf die in der Anfrage verwendete HTTP-Methode. Wenn Sie Ihre API mit Postman oder einem anderen Tool testen, erhalten Sie möglicherweise 400 Bad Request-Antworten. In diesem Fall gibt Ihnen die Antwortnachricht einen Hinweis darauf, was die Hauptursache für diesen Fehler sein könnte.
„Für den Aufruf wurde ein ungültiges Schema verwendet. Verwenden Sie http:///api/f44_demo/GetProduct_v1?prod_code=4“
Dies hängt damit zusammen, dass die Anfrage versucht hat, HTTPS auf einem HTTP-Endpunkt zu verwenden. Dieses Problem lässt sich beheben, indem Sie Ihre Anfragemethode auf HTTP umstellen oder das API-Schema und die zulässigen Methoden des Prozesses auf HTTPS ändern oder beides.
Ein weiterer Grund für diese 400 Bad Request-Antwort könnte ein ungültiger oder fehlender Abfrage- oder Pfadparameter sein. Um das Problem zu beheben, können Sie überprüfen, ob Sie den Pfad-/Abfrageparameter richtig eingestellt haben, oder das erforderliche Attribut in den API-Spezifikationen auf „false“ ändern.
Status 401 Nicht autorisiert
Eine nicht autorisierte Antwort kann mehrere Ursachen haben. Wenn Sie einen API-Schlüssel für die Verwendung im API-Endpunkt festgelegt haben, stellen Sie sicher, dass Ihrer Anfrage derselbe Schlüssel hinzugefügt wird. In Postman können Sie den API-Schlüssel ganz einfach auf der Registerkarte „Autorisierung“ festlegen. Kopieren Sie einfach den Schlüssel aus der Ansicht „Frends API Keys“ und fügen Sie ihn dort hinzu.
Andere Gründe für diese Art von Antwort können im Prozess selbst liegen. In Frends gibt es keine eigentliche Whitelist, aber Sie können beispielsweise ein Entscheidungselement verwenden, um die IP-Adresse des Anrufers zu überprüfen und eine Ausnahme vom Prozess mit dieser Art von Antwort auszulösen, wenn es nicht die richtige ist. Diese Funktionalität kann durch die Verwendung von Umgebungsvariablen erreicht werden.
Der nächste Artikel istEinführung in die Bereitstellung von APIs und die API-Versionskontrolle.
Verwandte ArtikelVerwaltungs-APIBeispiel zum Erstellen eines neuen verknüpften ProzessesBeispiel zur Verwendung von #ProzessreferenzenEinführung in die Implementierung von EndpunktenBeispiel zum Erstellen eines verknüpften Prozesses