{"id":1589,"date":"2017-12-18T11:05:58","date_gmt":"2017-12-18T11:05:58","guid":{"rendered":"http:\/\/www.portatour.com\/blog\/users\/?p=1589"},"modified":"2017-12-18T16:58:05","modified_gmt":"2017-12-18T16:58:05","slug":"api-mail-bei-fehlern","status":"publish","type":"post","link":"https:\/\/www.portatour.com\/blog\/users\/de\/2017\/12\/18\/api-mail-bei-fehlern\/","title":{"rendered":"API sendet E-Mail-Benachrichtigungen bei Fehlern"},"content":{"rendered":"<p><em>Hinweis: Folgender Artikel\u00a0richtet sich\u00a0prim\u00e4r an portatour\u00ae-Administratoren von Firmenzug\u00e4ngen (2 oder mehr Benutzern).<\/em><\/p>\n<p>Schon sehr viele Unternehmen nutzen die API von portatour\u00ae Anywhere zum regelm\u00e4\u00dfigen automatischen Importieren und Exportieren von Daten. Das freut uns nat\u00fcrlich sehr.<\/p>\n<p>Wir haben allerdings im Zuge von Logfile-Analysen festgestellt, dass in manchen F\u00e4llen keine Ursachenbehebung bei fehlerhaften API-Aufrufen stattfindet. D.h. dieselben\u00a0fehlerhaften Aufrufe werden t\u00e4glich\u00a0wieder und wieder erfolglos versucht.<\/p>\n<p>Durch diese Fehler, die h\u00e4ufig durch Dateninkonsistenzen in der Importdatei begr\u00fcndet sind, schl\u00e4gt der API-Aufruf g\u00e4nzlich fehl. Der Au\u00dfendienstmitarbeiter erh\u00e4lt keine aktuellen Daten. Oft wird das Problem erst\u00a0nach Tagen oder Wochen durch Reklamation des Benutzers selbst identifiziert und behoben.<\/p>\n<p>Mit dem heutigen Update der portatour\u00ae API schaffen wir Abhilfe, damit in Zukunft Fehler schnell erkannt und gel\u00f6st werden, bevor Benutzer betroffen sind.<\/p>\n<p>Wenn ein API-Aufruf fehlschl\u00e4gt, wird durch portatour\u00ae automatisch eine E-Mail mit einer genauen Aufruf- und Fehlerbeschreibung\u00a0an die E-Mail-Adresse jenes Administratorkontos gesendet, dessen Anmeldedaten f\u00fcr den API-Aufruf verwendet wurden. Sie als Administrator\u00a0k\u00f6nnen\u00a0zeitnah mit der Ursachenbehebung beginnen. Stellen Sie unbedingt sicher, dass beim verwendeten Administratorkonto\u00a0eine korrekte E-Mail-Adresse eingetragen ist, dessen Postfach auch gelesen wird.<\/p>\n<p><em>Hinweis: Um bei Fehlern, die viele Benutzerkonten und somit viele API-Aufrufe betreffen, keine Flut an E-Mails zu generieren, erfolgt der automatische E-Mail-Versand nach einem fehlerhaften API-Aufruf immer zumindest eine Minute verz\u00f6gert. Wenn in dieser Minute weitere fehlerhafte API-Aufrufe passieren, werden alle Fehlermeldungen in eine einzige\u00a0Mail zusammengefasst und der E-Mail-Versand weiter verz\u00f6gert. Wundern Sie sich daher nicht, warum E-Mails im Fehlerfall\u00a0immer zumindest eine Minute verz\u00f6gert in Ihrem Postfach eintreffen. <\/em><\/p>\n<p>Wir m\u00f6chten Sie an dieser Stelle gleich beruhigen: Meist geht es darum, Sonderf\u00e4lle in den Daten oder im Ablauf, die bei der anf\u00e4nglichen Programmierung der Datensynchronisation mittels der\u00a0API noch nicht bekannt waren, einmalig in Ihrem Programmcode bzw. Prozess abzubilden. Danach sollten die API-Aufrufe\u00a0dauerhaft fehlerfrei durchlaufen.<\/p>\n<p>Der automatische E-Mail-Versand bei Fehlern ist nicht deaktivierbar. Es sollte immer das Ziel sein, die Ursache des Fehlers zu beheben, da ansonsten der API-Aufruf ohnehin fehlschl\u00e4gt.<\/p>\n<p>Bitte ber\u00fccksichtigen Sie, dass\u00a0die E-Mail-Benachrichtigung\u00a0viele der m\u00f6glichen Fehler in der Automatisation abdeckt, allerdings nicht allumfassend ist. Zum\u00a0Beispiel erfolgt bei folgenden zwei Problemszenarien keine E-Mail durch portatour\u00ae:<\/p>\n<ul>\n<li>Wenn Sie ung\u00fcltige Administratorzugangsdaten (Benutzername + Passwort) beim API-Aufruf verwenden. portatour\u00ae kann dadurch Ihre E-Mail-Adresse nicht\u00a0identifizieren.<\/li>\n<li>Wenn\u00a0auf Ihrer Seite bereits in einem Vorverarbeitungsschritt ein Fehler auftritt und der Programmfluss gar nicht zum\u00a0eigentlichen API-Aufruf weiterl\u00e4uft.<\/li>\n<\/ul>\n<p>Sollten Sie generell Unterst\u00fctzung bei der API-Nutzung ben\u00f6tigen, bieten wir gerne einen individuellen\u00a0<a href=\"http:\/\/www.portatour.com\/services\/de#apiworkshop\">Workshop<\/a> dazu an.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Hinweis: Folgender Artikel\u00a0richtet sich\u00a0prim\u00e4r an portatour\u00ae-Administratoren von Firmenzug\u00e4ngen (2 oder mehr Benutzern). Schon sehr viele Unternehmen nutzen die API von portatour\u00ae Anywhere zum regelm\u00e4\u00dfigen automatischen Importieren und Exportieren von Daten. Das freut uns nat\u00fcrlich sehr. Wir haben allerdings im Zuge von Logfile-Analysen festgestellt, dass in manchen F\u00e4llen keine Ursachenbehebung bei fehlerhaften API-Aufrufen stattfindet. D.h. dieselben\u00a0fehlerhaften [&hellip;]<\/p>\n","protected":false},"author":4,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[],"class_list":["post-1589","post","type-post","status-publish","format-standard","hentry","category-anywhere-de"],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/www.portatour.com\/blog\/users\/de\/wp-json\/wp\/v2\/posts\/1589","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.portatour.com\/blog\/users\/de\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.portatour.com\/blog\/users\/de\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.portatour.com\/blog\/users\/de\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/www.portatour.com\/blog\/users\/de\/wp-json\/wp\/v2\/comments?post=1589"}],"version-history":[{"count":12,"href":"https:\/\/www.portatour.com\/blog\/users\/de\/wp-json\/wp\/v2\/posts\/1589\/revisions"}],"predecessor-version":[{"id":1730,"href":"https:\/\/www.portatour.com\/blog\/users\/de\/wp-json\/wp\/v2\/posts\/1589\/revisions\/1730"}],"wp:attachment":[{"href":"https:\/\/www.portatour.com\/blog\/users\/de\/wp-json\/wp\/v2\/media?parent=1589"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.portatour.com\/blog\/users\/de\/wp-json\/wp\/v2\/categories?post=1589"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.portatour.com\/blog\/users\/de\/wp-json\/wp\/v2\/tags?post=1589"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}