Wie man mit dem Konvertierungsdienst über Postman anfängt
Postman ist ein kostenlos herunterladbares Tool zum Erstellen von HTTP-Anfragen. Es kann verwendet werden, um zu testen und sich mit jeder REST-API vertraut zu machen, wie der, die vom 4-Heights® Konvertierungsdienst angeboten wird.
System einrichten
Laden Sie den 4-Heights® Konvertierungsdienst herunter und installieren Sie ihn.
Herunterladen: 30-Tage-Test
Ausführlichere Anweisungen: Handbuch
Laden Sie Postman herunter und installieren Sie es.
Anforderungsammlung in Postman importieren
Sammlung herunterladen: Postman-Sammlung
Öffnen Sie Postman und klicken Sie auf Importieren.
Ziehen Sie die heruntergeladene Sammlung in das Importfenster.
Klicken Sie auf 4-Heights® Konvertierungsdienst in der Sammlungsansicht.
Probieren Sie es aus
Zuerst sicherstellen, dass das baseURL in Ihren Sammlungsvariablen den Host angibt, auf dem Ihr 4-Heights® Konvertierungsdienst läuft.
Werfen Sie einen Blick auf die verfügbaren Anforderungen: API-Referenz
Um sich mit Postman vertraut zu machen, versuchen Sie eine einfache Anfrage: verfügbare Workflows auflisten.
Das ist nützlich, um einen Überblick über die verfügbaren Workflows zu erhalten.
Der Name eines Workflows kann dann als Eingabeparameter verwendet werden, wenn Sie einen neuen Job erstellen.
Verarbeiten Sie Ihre erste Datei (für weitere Informationen über die Sequenz der Jobverarbeitung, siehe Abschnitt "API-Nutzung" in der Handbuch)
Neuen Job erstellen mit einem Workflow Ihrer Wahl.
Der Job ist erstellt und bereit für Daten.
Die ID des neu erstellten Jobs wird in der Sammlungsvariablen gespeichert jobId und automatisch für nachfolgende Anforderungen verwendet.
Job-Info abrufen um zu überprüfen, ob ein Job tatsächlich erstellt wurde.
Die Antwort sollte Ihnen mitteilen, dass der Status des Jobs "erzeugt" ist.
Daten zum Job hinzufügen (Datei in wählen Körper Tab).
Sie können diesen Schritt mehrere Male mit verschiedenen Dateien wiederholen, um zusätzliche Daten zu Ihrem Job hinzuzufügen.
Job starten
Der Konvertierungsdienst beginnt mit der Verarbeitung aller Dokumente, die Sie dem Job hinzugefügt haben.
Job-Info abrufen nochmals.
Die Antwort sollte Ihnen nun mitteilen, dass der Status des Jobs "abgeschlossen" ist (oder "Verarbeitung", wenn Sie große Dateien hinzugefügt haben und es noch nicht abgeschlossen ist).
Job-Ergebnis abrufen um Informationen über das Ergebnis zu erhalten
Die ID des ersten Ergebnismengensatzes wird in der Sammlungsvariablen gespeichert resultId und automatisch in der nachfolgenden Anfrage verwendet.
Wenn Ihr Workflow mehr als einen Ergebnismengensatz zurückgibt, kopieren Sie alle IDs.
Job-Ergebnisdaten abrufen um das tatsächlich vom Konvertierungsdienst erzeugte Dokument zu erhalten.
Speichern Sie die Antwort als PDF-Datei, um sie anzuzeigen (klicken Sie auf Antwort speichern, dann In Datei speichern auf der rechten Seite).
Job löschen um alle für die Verarbeitung verwendeten Ressourcen freizugeben.
Alle mit dem Job verbundenen Sammlungsvariablen werden zurückgesetzt.
Zusammenfassung
Die Digitalisierung hat die Prozesse für den Eingang von Post radikal verändert. Die Bearbeitungs- und Reaktionszeiten können trotz des enormen Anstiegs der möglichen Formen und Formate, die in der "Inbox" landen, erheblich reduziert werden.