Bouw met Etchify.

AI-integratie en directe REST API in elk plan, ook in de proefperiode. OpenAPI-spec, MCP-endpoint, 36 tools: 15 lezen, 21 schrijven. Real-time order push via Shopify's native orders/create webhook.

Quickstarts

Kies het frontend dat je al gebruikt. Elke setup begint met de API-sleutel uit de Etchify-admin.

Elk plan, ook in de proefperiode

Endpoints

Alle endpoints zijn via de API-sleutel beperkt tot één winkel.

OpenAPI-specificatie

Importeer deze URL in ChatGPT Custom GPT Actions of genereer een typed client.

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

Openen →

MCP-endpoint

Gebruik deze URL voor Claude.ai custom connectors en Claude Desktop / Claude Code mcpServers-config.

https://api.etchify.app/mcp

Authenticatie

Elk verzoek heeft een header nodig.

X-API-Key: sk_etch_...

✓Roteer of trek in op elk moment vanuit Instellingen → AI-integratie in de Etchify-admin.
✓Elke sleutel is gekoppeld aan één winkel. Sleutels verlaten nooit je Shopify-admin tot je ze kopieert — ze worden alleen één keer getoond bij generatie.

Rate-limits

Starter	60 req/min	Ruim voldoende voor menselijke AI-conversaties
Pro	60 req/min	Ruim voldoende voor menselijke AI-conversaties
Business	600 req/min	Gebouwd voor scripted bulk-operaties
Proef 14 dagen	600 req/min	Business-equivalent tijdens de proef

Foutcodes

Standaard HTTP. Body altijd JSON: { error, message, request_id }.

401Ontbrekende of misvormde X-API-Key header

403API-sleutel geldig maar zonder autorisatie voor dit endpoint

404Resource niet gevonden in deze winkel

409Conflict — resource bestaat al (alleen POST mutations)

429Rate-limit overschreden — zie Retry-After header

500Serverfout — request_id wordt gelogd, mail naar help@etchify.app

MCP- / REST-tool inventaris

36 tools: 15 lezen, 21 schrijven. De tabel toont de 15 lees-tools. Dezelfde tools via OpenAPI, MCP-HTTP, MCP-stdio of REST direct.

Tool	Doel
list-products	Lijst alle geconfigureerde producten in je winkel
get-product-config	Gedetailleerde config voor één product (materialen, modi, afmetingen)
browse-templates	Filter sjablonen op product, categorie of vorm
list-materials	Bibliotheek van alle geconfigureerde materialen
list-shapes	Bibliotheek van alle custom-vormen
list-all-templates	Vlakke lijst van alle sjablonen
health-check	Service-health en uptime-status
get-api-spec	Geeft de OpenAPI-spec inline terug
get-setup-guide	Walkthrough van resterende setup-stappen
diagnose-setup	Detecteert misconfiguraties tussen producten, materialen, vormen
shop-info	Winkelnaam, plan, install-datum, locale, valuta
list-orders	De bestellingen van de winkel, nieuwste eerst — status, product, designpreview, productiebestand klaar
get-order	Eén bestelling in detail
get-shop-stats	Gebruikscijfers van je klanten
show-image	Toont een design- of productafbeelding in de chat

Probeer deze prompts

Vraag je ChatGPT- of Claude-bridge om Etchify-data — kopieer een regel, plak 'm in je AI-frontend, klaar. 36 tools: 15 lezen, 21 schrijven draaien onder de motorkap.

Analytics & inzichten

Read-tools

Welke materialen verkopen deze maand het best?

Met welk template converteren klanten het vaakst?

Hoe hoog is mijn Etchify-omzetaandeel dit kwartaal?

Op welk materiaal ontwerpen de meeste klanten?

De bibliotheek inspecteren

Read-tools

Toon alle materialen in de categorie hout.

Welke producten gebruiken de shape 'Coaster Round'?

Wat zijn de productie-instellingen voor materiaal 'Eik 6mm'?

Welke templates zijn de afgelopen 30 dagen niet gebruikt?

Setup & debugging

Diagnose + write-tools

Mijn klant kan het design niet aan de winkelwagen toevoegen — wat kan er misgaan?

Leg me stap voor stap uit hoe ik PDF/X-1a-export voor mijn drukkerij inschakel.

Zet de productiemethode van dit product om naar printen.

Spoor verkeerd geconfigureerde API-keys in mijn setup op.

Vereist AI-integratie ingeschakeld. Je AI wijzigt de inrichting direct — producten die al te koop staan, wachten op jouw goedkeuring.

Integration Cookbook

Drie recepten voor eigenaren die Etchify in hun eigen workflows knopen — bulk-fetch via curl, real-time push via Shopify's native orders/create-webhook, n8n HTTP-node-config. Elke snippet draait tegen de REST API (elk plan).

Bulk-fetch van ontworpen bestellingen (curl)

Haal alle ontworpen bestellingen voor een datumbereik in je ERP. Maakt tabelimports en CSV-workflows overbodig, zonder extra tooling.

# 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'

Real-time push via Shopify orders/create

Bestellingen komen via Shopify's eigen bestel-webhooks in Etchify binnen — er is geen aparte Etchify-webhook om te verifiëren. Voor je ERP, een e-maildienst of een Slack-bridge abonneer je Shopify's orders/create-webhook; die bevat de Etchify-cart-properties van elke bestelling.

n8n HTTP Request-node

Drop-in JSON voor een n8n-workflow. Haalt elk uur nieuwe ontworpen bestellingen op met auth-header. Combineer met een schedule-trigger en Notion/Airtable-output.

// 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 zijn startsjablonen — vul je eigen API-keys, secrets en endpoints in. Real-time push gebruikt Shopify's orders/create-webhook (gratis in elk Shopify-plan), die elke Etchify-cart-property (_design_id, _design_url, _preview_url, maten als „Dimensions“; het materiaal zit in de variant) meestuurt — geen configuratie aan Etchify-zijde nodig.

Live: AI Write Tools + Directe REST

Real-time push (Shopify-native)

Abonneer Shopify's orders/create webhook op je endpoint — elke Etchify-cart-property (_design_id, _design_url, _preview_url, maten als „Dimensions“; het materiaal zit in de variant) wordt automatisch geleverd. HMAC-verificatie via Shopify's standaard signature. Gratis in elk Shopify-plan.

AI Write Tools

21 schrijf-tools voor AI-agents in elk plan: enable-product, create-shape, set-brand-colors, upload-shop-logo, create-template, set-production-method enz. Je AI wijzigt de inrichting direct — producten die al te koop staan, wachten op jouw goedkeuring.

API-changelog

Breaking-changes en nieuwe endpoints worden in de changelog bijgehouden.

Bekijk changelog →

Hulp nodig?

Mail naar help@etchify.app — Pro- en Business-plannen krijgen prioritaire routing.

help@etchify.app Terug naar AI-integratie