Einen Schlüssel erstellen.
In deinem Konto unter API-Schlüssel und Webhooks. Er wird einmal angezeigt. Sende ihn im Authorization-Header.
- Pro Zweck. Geltungsbereich und Ablaufdatum für jeden Schlüssel.
Alle WerkzeugeAutomation
Schick ein Kundenfoto an einen Endpunkt und bekomm die laserfertige Datei zurück, die Photo Studio dir liefern würde. Webhooks melden deinem System, wenn ein Job fertig ist oder fehlgeschlagen ist.
In Studio Pro und Business enthalten.
# request
curl -X POST https://vextrify.com/v1/prepare \
-H "Authorization: Bearer YOUR_KEY" \
-F "image=@photo.jpg" \
-F "materialId=birch" \
-F "laserId=co2" \
-F "goalId=balanced" \
-F "widthMm=100"
# response
{
"jobId": "5f2c…",
"image": { "format": "png", "base64": "iVBORw0…",
"widthPx": 1000, "heightPx": 750 },
"applied": { "materialId": "birch", "laserId": "co2",
"goalId": "balanced", "widthMm": 100,
"dpi": 254, "resolutionReduced": false }
}Sende das Bild mit einem Material, einem Lasertyp, einem Ziel und einer Breite. Du bekommst die vorbereitete Gravurdatei zurück, bereit zum Platzieren.
Die API nutzt dieselbe Vorbereitung wie Photo Studio. Die Antwort listet die Werte auf, die tatsächlich verwendet wurden, damit du jedes Ergebnis von Hand nachstellen kannst.
job.completed und job.failed kommen an deiner eigenen Adresse an. Der Fehlschlag erreicht dich, bevor dein Kunde nachfragt. Jede Zustellung ist signiert, sodass du prüfen kannst, dass sie von Vextrify kommt, und eine Zustellung ohne Antwort wird erneut versucht.
Erstelle für jedes System einen Schlüssel mit eigenem Geltungsbereich und eigenem Ablaufdatum. Der Wert wird einmal angezeigt. Widerrufst du einen Schlüssel, funktionieren die anderen weiter.
Die Ansicht der Zustellversuche zeigt, ob und wann ein Webhook angekommen ist. Sie ist die erste Stelle, an der du nachsiehst, wenn etwas fehlt.
Ein fehlender oder abgelaufener Schlüssel, ein Tarif ohne API, ein Schlüssel ohne Berechtigung, ein fehlendes Bild, ein unbekannter Wert mit genanntem Feld, eine zu große Datei mit der möglichen Breite, ein nicht lesbares Bild, ein ausgelasteter Moment mit der Wartezeit in Sekunden.
Jede Sprache, die HTTP spricht, funktioniert, ohne dass du eine Vextrify-Bibliothek installieren musst. Zapier, Make und n8n können denselben Endpunkt aufrufen und das Ergebnis an eine Tabelle, einen Shop, ein CRM oder einen Speicher weitergeben.
Fünf Schritte von einem Schlüssel zu einem fertigen Job in deinem System.
In deinem Konto unter API-Schlüssel und Webhooks. Er wird einmal angezeigt. Sende ihn im Authorization-Header.
Material, Lasertyp, Art des Motivs, Ziel, Breite und optional DPI. Nur das Bild ist Pflicht.
Eine Multipart-Anfrage. Die Antwort enthält das PNG und die angewendeten Werte.
Jeder Fehler hat einen Code und eine klare Meldung, die nennt, was du beheben musst.
Webhooks melden job.completed und job.failed. Prüfe die Signatur mit deinem Signaturgeheimnis, bevor du einer Zustellung traust.
Eine Bestellung kommt in deinem Shop an. Dein Server schickt das Foto mit dem Material und der Breite per POST.
Ein PNG, für dieses Material vorbereitet, und die angewendeten Werte.
Fertig oder fehlgeschlagen, signiert, an deine eigene Adresse.
Platziere das PNG in Laser Control oder in jeder anderen Lasersoftware. Vorbereitete Dateien aus der API und aus Photo Studio stimmen überein.
Die API ist in Studio Pro und Business enthalten. Du bereitest lieber viele Bilder von Hand vor? Nutze Batch Processing.
Einfach anfangen. Eine Gruppe öffnen, wenn du mehr willst.
Ein einziger Aufruf für den ganzen Weg vom Kundenfoto zur Gravurdatei.
Dein System erfährt den Ausgang, ohne nachfragen zu müssen.
Im Konto unter Entwickler.
Derselbe Endpunkt, bedient von einem Automatisierungsdienst.
Studio Pro und Business.
Ja. Dein Shop sendet das Kundenbild an POST /v1/prepare, bekommt die vorbereitete Datei zurück und erfährt über Webhooks, ob der Job fertig oder fehlgeschlagen ist. Ohne Code läuft derselbe Weg über Zapier, Make oder n8n.
Ein PNG als Base64 plus die angewendeten Werte, einschließlich der tatsächlichen DPI. Sende JPEG, PNG oder WebP bis 20 MB.