So funktioniert es

Eine Datei namens report.pdf ist nicht zwangsläufig ein PDF, und eine Datei ganz ohne Endung lässt sich meist trotzdem bestimmen. Deshalb lesen wir zuerst die ersten Bytes des Uploads und gleichen sie mit bekannten Formatsignaturen ab.

Das ist wichtiger, als es klingt. Wer der Endung vertraut, lässt eine umbenannte Datei entweder mit einer verwirrenden Fehlermeldung scheitern oder — schlimmer — dem falschen Werkzeug übergeben. Wer die Bytes liest, wandelt eine falsch benannte Datei trotzdem korrekt um und weist eine Datei, die wirklich nicht das ist, was sie vorgibt, klar zurück.

Jede unterstützte Umwandlung ist eine Kante zwischen zwei Formaten, und jede Kante hält fest, wie originalgetreu sie ist, wie aufwendig sie ungefähr ist und wie groß die Eingabe höchstens sein darf. Aus diesem Graphen werden die Formatseiten erzeugt, und er wird vollständig über die API veröffentlicht.

Gibt es zwischen den beiden genannten Formaten keine Kante, erfahren Sie das sofort und nicht erst nach dem Hochladen. Nichts wird stillschweigend über ein verlustbehaftetes Zwischenformat geleitet, damit eine Umwandlung funktionsfähig erscheint.

Ein Bild zu skalieren dauert deutlich weniger als eine Sekunde und läuft deshalb innerhalb der Anfrage — die Antwort enthält das Ergebnis bereits. Ein langes Dokument zu rendern oder Video umzukodieren dauert länger; solche Aufträge werden eingereiht und von einem eigenen Pool von Workern abgearbeitet.

Sie müssen nie raten, was Sie bekommen haben. Ein fertiger Auftrag kommt mit dem Ergebnis zurück, ein eingereihter mit einer Auftrags-ID, einer Position in der Warteschlange und einer Schätzung — und Sie fragen ihn ab oder warten auf die E-Mail.

Website, API und Umwandeln per E-Mail sind drei Türen zu einer Pipeline. Sie unterscheiden sich nur darin, wie der Aufrufende identifiziert wird — Sitzungscookie, Bearer-Token oder Absender einer E-Mail — und führen danach exakt denselben Code aus.

Das ist eine bewusste Einschränkung und kein Umsetzungsdetail. Zwei Implementierungen von „Kontingent prüfen, Bytes erkennen, Archiv absichern“ sind der Weg, auf dem eine davon irgendwann einen Schritt für genau die Aufrufenden auslässt, die es am wenigsten bemerken.