Entwickler
Personalisierte Laserprodukte über eine REST-API
Verbinden Sie Ihren eigenen Shop, einen Marktplatz oder ein internes System mit unserer Werkstatt. Erstellen Sie Designs, holen Sie genaue Angebote ein, geben Sie Bestellungen auf und verfolgen Sie sie per Webhook.
Die API öffnet nach unserem Shopify-Start. Fragen Sie einen frühen Zugang an und erzählen Sie uns, was Sie bauen.
Was Sie tun können
Alles, was Sie für personalisierte Produkte brauchen
Katalog abrufen
Vorlagen, Materialien, Größen, Schriften und Preise in Ihrer Währung, alle Texte in fünf Sprachen.
Designs erstellen
Laden Sie Kundenfotos hoch, senden Sie die Feldwerte und erhalten Sie ein Design mit Vorschaubild. Die Fotoauflösung prüfen wir für Sie.
Genaue Angebote
Artikel, Versand und Mehrwertsteuer für jedes Zielland, berechnet vom selben Code, der die Bestellung abrechnet.
Bestellen und verfolgen
Eine Anfrage pro Bestellung, bezahlt aus Ihrem Guthaben. Verfolgen Sie den Status und stornieren Sie, solange das noch möglich ist.
Webhooks bei jedem Schritt
Erstellt, zurückgestellt, in Produktion, versandt, zugestellt, dazu Warnungen bei niedrigem Guthaben. Jeder Webhook ist mit HMAC-SHA256 signiert.
Guthaben abfragen
Ihr Guthaben mit vollständigem Verlauf, damit Ihre Buchhaltung immer mit unserer übereinstimmt.
Beispiel
Eine Anfrage, eine Bestellung
Die Bestellung wird aus Ihrem Guthaben bezahlt. Die Antwort enthält unsere Bestellnummer und den Status, danach übernehmen die Webhooks.
curl https://api.staging.gravilo.eu/v1/orders \
-H "Authorization: Bearer gvl_live_…" \
-H "Idempotency-Key: 7d0f9a52-order-1042" \
-H "Content-Type: application/json" \
-d '{
"external_id": "1042",
"customer_locale": "de",
"ship_to": {
"name": "Lena Schmidt",
"line1": "Lindenstraße 12",
"postal_code": "10969",
"city": "Berlin",
"country": "DE"
},
"items": [
{ "design_id": "0192a5c4-7b1e-7c3d-9f00-5d1e2a3b4c5d", "quantity": 2 }
]
}'HTTP/1.1 201 Created
{
"id": "0192a5c4-8f02-7a11-b3c0-1e9d4c7a2b60",
"number": "GV-001042",
"external_id": "1042",
"is_test": false,
"status": "received",
"hold_reason": null,
"billing_status": "charged",
"placed_at": "2026-10-08T09:41:00Z"
}Für Integrationen gebaut
Vorhersehbar, testbar, dokumentiert
Testmodus
Testschlüssel prüfen und berechnen Bestellungen, ohne etwas abzurechnen oder zu fertigen.
Sichere Wiederholungen
Senden Sie bei jedem POST einen Idempotency-Key. Dieselbe Anfrage erzeugt nie zwei Bestellungen.
OpenAPI 3.1
Eine maschinenlesbare Spezifikation und Referenzdokumentation, erzeugt aus den Schemas, mit denen die API validiert.
Klare Fehler
Problem Details (RFC 9457) mit stabilen Codes und genau dem Feld, das korrigiert werden muss.
Bereit für den Start?
Starten Sie mit der Shopify-App oder binden Sie Ihr eigenes System per API an.