Alle WerkzeugeAutomation

Dein Shop spricht mit dem Laser.

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.

POST /v1/prepare
# 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 }
}
1Endpunkt: POST /v1/prepare
12Materialien zur Auswahl
3Lasertypen: CO2, Faser, Diode
2Webhook-Ereignisse: job.completed und job.failed

Was es für dich tut.

  1. Ein Aufruf

    Vom Kundenfoto zur Laserdatei in einer Anfrage.

    Sende das Bild mit einem Material, einem Lasertyp, einem Ziel und einer Breite. Du bekommst die vorbereitete Gravurdatei zurück, bereit zum Platzieren.

  2. Gleiches Ergebnis

    Die Datei, die Photo Studio dir liefern würde.

    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.

  3. Webhooks

    Rückmeldung, ohne nachzufragen.

    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.

  4. Schlüssel

    Ein Schlüssel pro Zweck.

    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.

  5. Zustellprotokoll

    Sieh, was angekommen ist.

    Die Ansicht der Zustellversuche zeigt, ob und wann ein Webhook angekommen ist. Sie ist die erste Stelle, an der du nachsiehst, wenn etwas fehlt.

  6. Klare Fehler

    Jeder Fehler sagt dir, was du ändern musst.

    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.

  7. Ohne Code

    Funktioniert mit den Werkzeugen, die du schon nutzt.

    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.

So funktioniert es.

Fünf Schritte von einem Schlüssel zu einem fertigen Job in deinem System.

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.

Den Job beschreiben.

Material, Lasertyp, Art des Motivs, Ziel, Breite und optional DPI. Nur das Bild ist Pflicht.

  • Standardwerte. Lass ein Feld weg, und ein sinnvoller Standardwert gilt.

Das Bild senden, die Datei bekommen.

Eine Multipart-Anfrage. Die Antwort enthält das PNG und die angewendeten Werte.

  • Nachvollziehbar. Öffne dieselben Einstellungen in Photo Studio, um ein Ergebnis zu prüfen.

Die Antwort lesen.

Jeder Fehler hat einen Code und eine klare Meldung, die nennt, was du beheben musst.

  • Hinweise zum Wiederholen. Ein ausgelasteter Moment liefert zurück, wie viele Sekunden du warten sollst.

Von jedem Job erfahren.

Webhooks melden job.completed und job.failed. Prüfe die Signatur mit deinem Signaturgeheimnis, bevor du einer Zustellung traust.

  • Wiederholungen. Unbeantwortete Zustellungen werden erneut versucht.
Die Seite der Entwicklerschnittstelle: Authentifizierung und die Anfragefelder
Die Seite der Entwicklerschnittstelle: ein Anfragebeispiel und die Antwort
Die Seite der Entwicklerschnittstelle: die Liste der Fehlercodes
Die Seite der Entwicklerschnittstelle: Webhooks und Signaturprüfung

Von deinem System zum Laser.

1

Dein System sendet das Bild.

Eine Bestellung kommt in deinem Shop an. Dein Server schickt das Foto mit dem Material und der Breite per POST.

2

Vextrify liefert die Datei.

Ein PNG, für dieses Material vorbereitet, und die angewendeten Werte.

3

Ein Webhook meldet den Job.

Fertig oder fehlgeschlagen, signiert, an deine eigene Adresse.

4

Der Laser bekommt die Datei.

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.

Jede Einstellung, wenn du sie brauchst.

Einfach anfangen. Eine Gruppe öffnen, wenn du mehr willst.

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.
Komplette Funktionsreferenz

Fragen.

Welche Tarife enthalten die API?

Studio Pro und Business.

Kann ich meinen Shop mit der Lasergravur verbinden?

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.

Was bekomme ich zurück?

Ein PNG als Base64 plus die angewendeten Werte, einschließlich der tatsächlichen DPI. Sende JPEG, PNG oder WebP bis 20 MB.

Verbinde deinen Shop mit dem Laser.