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.
Ihr Teil, unser Teil
Sie wählen aus und legen die Preise fest. Wir erledigen den Rest.
Kein Design, kein Lager, kein Packtisch, keine Verträge mit Paketdiensten. Personalisierte Produkte zu verkaufen braucht auf Ihrer Seite nur ein paar Entscheidungen.
Was Sie tun
Ein paar Minuten pro Produkt
- Produkte aus unserem Katalog wählen
- Ihre Preise festlegen
- Jede Bestellung mit einer API-Anfrage senden
Was Gravilo tut
Für jede Bestellung, jeden Tag
- Vorschaubilder für Ihre Produktseiten
- Schneiden und Gravieren auf unseren CO2-Lasern
- Eine Qualitätskontrolle jedes Stücks
- Verpackung ohne unser Branding
- Versand in die ganze EU, mit Sendungsverfolgung
- Die Sendungsverfolgung zurück an Ihren Shop oder Ihr System
- Zurückgesendete Pakete, aufbewahrt bis zu Ihrer Wahl: zurückgeschickt oder vernichtet
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.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.