Bau mit Etchify.

AI-Integration im Pro, direkte REST-API im Business. OpenAPI-Spec, MCP-Endpoint, 36 Werkzeuge: 15 lesen, 21 schreiben im Pro · direkte REST-API für eigene Software im Business. Echtzeit-Order-Push via Shopifys nativem orders/create-Webhook.

Quickstarts

Wähle das Frontend das du eh schon nutzt. Jedes Setup dauert 3-5 Minuten nach API-Key-Generierung.

Pro-Plan

ChatGPT Custom GPT

5 Min.

Setup-Anleitung

Pro-Plan

Claude.ai Connector

3 Min.

Setup-Anleitung

Pro-Plan

Claude Desktop / Code

5 Min.

Setup-Anleitung

Business-Plan

REST-API direkt

Code-Time

Setup-Anleitung

Endpoints

Alle Endpoints sind über den API-Key auf einen Shop scoped.

OpenAPI-Spezifikation

Importiere diese URL in ChatGPT Custom GPT Actions oder generiere einen typisierten Client.

https://api.etchify.app/api/openapi.json

Öffnen →

MCP-Endpoint

Nutze diese URL für Claude.ai Custom-Connectors und Claude Desktop / Claude Code mcpServers-Config.

https://api.etchify.app/mcp

Authentifizierung

Jeder Request braucht einen Header.

X-API-Key: sk_etch_...

✓Jederzeit unter Einstellungen → AI Integration im Etchify-Admin rotieren oder widerrufen.
✓Jeder Key ist auf einen Shop gescoped. Keys verlassen niemals deinen Shopify-Admin bis du sie kopierst — sie werden nur einmal beim Generieren angezeigt.

Rate-Limits

Starter	—	Kein API-Zugriff im Starter
Pro	60 req/min	Reicht locker für menschliche AI-Konversationen
Business	600 req/min	Gebaut für Skript-getriggerte Bulk-Operationen
14-Tage-Trial	600 req/min	Business-äquivalent im Trial

Error-Codes

Standard-HTTP. Body ist immer JSON: { error, message, request_id }.

401Fehlender oder fehlerhafter X-API-Key Header

403API-Key valid aber Plan enthält diesen Endpoint nicht (z.B. AI im Starter, REST im Pro)

404Resource in diesem Shop nicht gefunden

409Conflict — Resource existiert bereits (nur POST-Mutations)

429Rate-Limit überschritten — siehe Retry-After Header

500Server-Error — request_id ist geloggt, schreibe an help@etchify.app

MCP-/REST-Tool-Inventar

36 Werkzeuge: 15 lesen, 21 schreiben. Die Tabelle zeigt die 15 zum Lesen. Gleiche Werkzeuge egal ob über OpenAPI, MCP-HTTP, MCP-stdio oder REST direkt.

Tool	Zweck	Plan
list-products	Listet alle konfigurierten Produkte deines Shops	Pro+
get-product-config	Detail-Config für ein Produkt (Materialien, Modi, Maße)	Pro+
browse-templates	Filtert Templates nach Produkt, Kategorie oder Shape	Pro+
list-materials	Library aller im Shop konfigurierten Materialien	Pro+
list-shapes	Library aller Custom-Shapes	Pro+
list-all-templates	Flache Liste aller Templates über alle Produkte	Pro+
health-check	Service-Health und Uptime-Status	Pro+
get-api-spec	Gibt die OpenAPI-Spec inline zurück	Pro+
get-setup-guide	Walkthrough der noch fehlenden Setup-Schritte	Pro+
diagnose-setup	Erkennt Fehlkonfigurationen quer über Produkte, Materialien, Shapes	Pro+
shop-info	Shop-Name, Plan, Install-Datum, Locale, Währung	Pro+
list-orders	Bestellungen des Shops, neueste zuerst — Status, Produkt, Design-Vorschau, Produktionsdatei bereit	Pro+
get-order	Eine Bestellung im Detail	Pro+
get-shop-stats	Nutzungszahlen deiner Kunden	Pro+
show-image	Zeigt ein Design- oder Produktbild im Chat	Pro+

Probier diese Prompts

Frag deinen ChatGPT- oder Claude-Verbund nach Etchify-Daten — kopier eine Zeile, paste sie in dein AI-Frontend, fertig. 36 Werkzeuge: 15 lesen, 21 schreiben liegen unter der Haube.

Analytics & Insights

Read-Tools

Welche Materialien verkaufen sich diesen Monat am besten?

Welches Template konvertiert bei Customers am häufigsten?

Wie hoch ist mein Etchify-Anteil am Umsatz dieses Quartal?

Auf welchem Material designen die meisten Kunden?

Bibliothek inspizieren

Read-Tools

Liste mir alle Materialien in der Kategorie Holz.

Welche Produkte nutzen die Shape 'Coaster Round'?

Was sind die Production-Settings für Material 'Eiche 6mm'?

Welche Templates wurden in den letzten 30 Tagen kein einziges Mal genutzt?

Setup & Debugging

Diagnose + Write-Tools (Pro+)

Mein Kunde kann das Design nicht in den Warenkorb legen — was könnte schief gehen?

Führe mich durch die Aktivierung von PDF/X-1a-Export für meinen Print-Shop.

Stell das Verfahren dieses Produkts auf Druck um.

Erkenne fehlerhafte API-Key-Konfigurationen in meinem Setup.

Voraussetzung: AI-Integration aktiviert (Pro+). Deine KI ändert die Einrichtung direkt — Produkte, die schon im Verkauf sind, warten auf deine Freigabe.

Integration Cookbook

Drei Rezepte für Owner die Etchify in eigene Workflows einbinden — Bulk-Fetch via curl, Echtzeit-Push via Shopifys nativem orders/create-Webhook, n8n-HTTP-Node-Config. Alle Snippets nutzen die REST-API (Business+).

Bulk-Abruf gestalteter Bestellungen (curl)

Ziehe alle gestalteten Bestellungen eines Zeitraums in dein ERP. Löst Tabellen-Importe und CSV-Workflows ohne weitere Tools.

# Fetch designed orders since yesterday
curl -X GET 'https://api.etchify.app/api/v1/orders?since=2026-05-03T00:00:00Z&status=designed' \
  -H 'X-API-Key: shop_etchify_xxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json'

# Fetch designed orders since yesterday
curl -X GET 'https://api.etchify.app/api/v1/orders?since=2026-05-03T00:00:00Z&status=designed' \
  -H 'X-API-Key: shop_etchify_xxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Accept: application/json'

Echtzeit-Push via Shopifys orders/create

Bestellungen kommen über Shopifys eigene Bestell-Webhooks in Etchify an — es gibt keinen eigenen Etchify-Webhook, den du prüfen müsstest. Für dein ERP, E-Mail-Tool oder eine Slack-Bridge abonnierst du Shopifys orders/create-Webhook; er enthält die Etchify-Cart-Properties jeder Bestellung.

n8n HTTP-Request-Node

Drop-in JSON für einen n8n-Workflow. Ruft stündlich neue gestaltete Bestellungen mit Auth-Header ab. Kombinierbar mit Schedule-Trigger und Notion/Airtable-Out.

// n8n HTTP Request node config (manual export to JSON)
{
  "method": "GET",
  "url": "https://api.etchify.app/api/v1/orders",
  "authentication": "genericCredentialType",
  "genericAuthType": "httpHeaderAuth",
  "sendQuery": true,
  "queryParameters": {
    "parameters": [
      { "name": "since", "value": "{{$now.minus({hours:1}).toISO()}}" },
      { "name": "status", "value": "designed" }
    ]
  },
  "options": { "response": { "response": { "responseFormat": "json" } } }
}

// n8n HTTP Request node config (manual export to JSON)
{
  "method": "GET",
  "url": "https://api.etchify.app/api/v1/orders",
  "authentication": "genericCredentialType",
  "genericAuthType": "httpHeaderAuth",
  "sendQuery": true,
  "queryParameters": {
    "parameters": [
      { "name": "since", "value": "{{$now.minus({hours:1}).toISO()}}" },
      { "name": "status", "value": "designed" }
    ]
  },
  "options": { "response": { "response": { "responseFormat": "json" } } }
}

Snippets sind Starter-Templates — passe API-Keys, Secrets und Endpoints an deinen Stack an. Echtzeit-Push nutzt Shopifys orders/create-Webhook (kostenlos in jedem Shopify-Plan), der jede Etchify-Cart-Property (_design_id, _preview_url, material, size) ausliefert — kein Etchify-seitiges Setup nötig.

Live: AI Write Tools + Direkte REST

Echtzeit-Push (Shopify-native)

Abonniere Shopifys orders/create-Webhook auf deinen Endpoint — jede Etchify-Cart-Property (_design_id, _preview_url, material, size) wird automatisch ausgeliefert. HMAC-Verify via Shopifys Standard-Signatur. Kostenlos in jedem Shopify-Plan.

AI Write Tools (Pro+)

21 Werkzeuge zum Schreiben für AI-Agenten auf Pro und Business: enable-product, create-shape, set-brand-colors, upload-shop-logo, create-template, set-production-method u. a. Deine KI ändert die Einrichtung direkt — Produkte, die schon im Verkauf sind, warten auf deine Freigabe.

API-Changelog

Breaking-Changes und neue Endpoints werden im Changelog getrackt.

Changelog ansehen →

Brauchst du Hilfe?

Schreibe an help@etchify.app — Pro- und Business-Pläne bekommen Priority-Routing.

help@etchify.app Zurück zur AI-Integration