Alle Werkzeuge
Programmierschnittstelle

Dernium Transit

Der programmatische Weg für Unternehmen mit eigener Software-Entwicklung: Datei hinein, geprüfte oder bereinigte Datei zurück - direkt in Ihr HR-Portal, CRM oder jede andere Eigenentwicklung.

  • REST-API mit Webhook-Callbacks - Sie bekommen das Ergebnis aktiv zugestellt, ohne pollen zu müssen
  • Synchron für kleine Dateien (kein Polling nötig) oder asynchron mit HMAC-signiertem Webhook
  • Pipeline-Komposition: Scan, Metadaten-Entfernung und PDF-Bereinigung in einem einzigen Aufruf - mit "Bei Schadbefund nicht weiter bereinigen"-Regel
  • Multi-Mandanten-Modell: pro Team ein eigener API-Key mit getrenntem Kontingent
  • Pro Aufruf eine opake Metadaten-Map (z. B. {applicant_id}), die im Webhook unverändert zurückkommt - sauberer Bezug zu Ihrem lokalen Datensatz
  • OpenAPI-3.1-Vertrag mit dokumentiertem Breaking-Change-Prozess (30 Tage Vorlauf ab v1.0) - Beispielcode für curl, Python und Node.js

Warum API statt manuelles Hochladen?

Transit ist der Baustein für alles, was automatisch passieren soll: eingehende Bewerbungsdateien, Vertragsentwürfe, medizinische Bilder, Anhänge aus Eingangs-Kanälen. Ein Aufruf, ein klares Ergebnis, eine Audit-Spur.

Abgrenzung zum Upload-Widget

Transit richtet sich an Teams mit eigener Entwicklung. Wer Dateien von Endbesuchern einer Website entgegennehmen möchte, nutzt das fertige Upload-Widget. Technisch steckt derselbe Motor dahinter.

Warum nicht Scan/Clean per Skript ansprechen?

Die Web-Tarife von Scan und Clean sind für die interaktive Nutzung durch Endanwender Ihrer Organisation gedacht. Transit ist der vertraglich saubere Pfad für die programmatische Server-zu-Server-Anbindung Ihrer Backend-Systeme - mit OpenAPI-Vertrag und SemVer-Garantie statt einer internen Web-Schnittstelle, die wir jederzeit refactorn können. Wer fremde Daten (Bewerber, Mandanten, Patienten) durch die Pipeline schiebt, braucht ohnehin die Pipeline-Komposition, Webhooks und Multi-Mandanten-Quoten, die nur Transit hat.

Onboarding und Tokenausgabe

Transit-Zugänge richten wir handverlesen ein - kein Self-Service-Klick. Eine E-Mail an support@dernium.de mit Organisationsname, Anwendungsfall (welche Dateien, welches System ruft Transit auf) und gewünschtem Tarif reicht. Wir vereinbaren ein kurzes Onboarding-Telefonat, klären Pipeline-Schritte, gegebenenfalls Webhook-Empfangs-Host, und übergeben den ersten API-Token im Klartext (einmalig sichtbar). Inkl. Beispielcode für Ihre Plattform und 30 Tage Begleitung beim Live-Schalten.