Automation

Automation — API & Webhooks

Der Endpunkt, den der Wettbewerb nicht hat.

Alles, was du in Photo Studio erarbeitest, lässt sich auch ohne Bildschirm auslösen. Ein Aufruf schickt das Bild, die Antwort enthält die laserfertige Datei, und Webhooks melden den Ausgang an dein System zurück.

Tool öffnen Funktion ansehen
Endpunkt

Ein einziger Aufruf für den ganzen Weg vom Kundenfoto zur Gravurdatei.

POST /v1/prepare
Nimmt ein Bild entgegen, bereitet es mit deinem Rezept auf und gibt die laserfertige Datei zurück.
Authentifizierung
Kundenschlüssel im Kopf der Anfrage; ohne gültigen Schlüssel antwortet der Endpunkt mit 401.
Geltungsbereich
Jeder Schlüssel trägt seinen Zweck; deckt er den Aufruf nicht ab, antwortet der Endpunkt mit 403.
Obergrenze
Bildgröße und Ausgabefläche sind begrenzt, damit ein einzelner Aufruf die Produktion nicht blockiert.
Webhooks

Dein System erfährt den Ausgang, ohne nachfragen zu müssen.

job.completed
Meldet den fertigen Auftrag an deine Adresse.
job.failed
Meldet den Fehlschlag — wertvoller als die Erfolgsmeldung, weil ein untaugliches Bild dich vor deinem Kunden erreichen muss.
Signatur
Jede Zustellung ist signiert, damit du prüfen kannst, dass sie wirklich von Vextrify stammt.
Adressprüfung
Ziele in internen Netzen werden abgelehnt, damit die Zustellung nicht als Werkzeug gegen dein eigenes Netz dienen kann.
Schlüssel verwalten

Im Konto unter Entwickler.

Schlüssel anlegen
Erzeugt einen neuen Schlüssel mit Zweck und Ablaufdatum; der Wert ist nur einmal sichtbar.
Schlüssel sperren
Nimmt einen einzelnen Zugang aus dem Verkehr, ohne die anderen zu berühren.
Zustellversuche
Zeigt, ob und wann ein Webhook angekommen ist — die erste Anlaufstelle, wenn etwas fehlt.
Ohne Programmierung

Derselbe Endpunkt, bedient von einem Automatisierungsdienst.

Zapier, Make, n8n
Rufen den Endpunkt auf und reichen das Ergebnis weiter — an Tabelle, Shop, CRM, Ablage oder Benachrichtigung.
Eigene Skripte
Jede Sprache, die HTTP kann, reicht aus; es braucht keine Vextrify-Bibliothek.
Häufige Fehler & Lösungen
401 oder 403
Lösung: Schlüssel fehlt, ist abgelaufen oder sein Geltungsbereich deckt den Aufruf nicht ab.
Webhook kommt nicht an
Lösung: Zieladresse muss öffentlich erreichbar sein; interne Netze werden bewusst abgelehnt. Zustellversuche im Entwicklerbereich prüfen.
Bild wird abgelehnt
Lösung: Obergrenze für Bildgröße überschritten — vorher skalieren.
Nicht offensichtlich
  • Ein Schlüssel je Zweck: fällt einer auf, sperrst du nur diesen Weg.
  • Erst in Photo Studio das Rezept erarbeiten, dann automatisieren — die Schnittstelle benutzt dasselbe Rezept.
  • Signatur immer prüfen, sonst kann jeder deinem System etwas unterschieben.