Costruisci con Etchify.

Integrazione IA e API REST diretta in ogni piano, prova inclusa. Spec OpenAPI, endpoint MCP, 36 tool: 15 di lettura, 21 di scrittura. Push in tempo reale via il webhook orders/create nativo di Shopify.

Quickstart

Scegli il frontend che già usi. Ogni configurazione inizia con la chiave API dall’admin di Etchify.

Tutti i piani, prova inclusa

Endpoint

Tutti gli endpoint sono limitati a un singolo negozio tramite la chiave API.

Specifica OpenAPI

Importa questo URL nelle Azioni di ChatGPT Custom GPT o genera un client tipizzato.

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

Apri →

Endpoint MCP

Usa questo URL per i connettori custom di Claude.ai e la config mcpServers di Claude Desktop / Claude Code.

https://api.etchify.app/mcp

Autenticazione

Ogni richiesta ha bisogno di un header.

X-API-Key: sk_etch_...

✓Ruota o revoca in qualsiasi momento da Impostazioni → Integrazione IA nell'admin Etchify.
✓Ogni chiave è limitata a un negozio. Le chiavi non lasciano mai il tuo admin Shopify finché non le copi — vengono mostrate solo una volta alla generazione.

Rate-limit

Starter	60 req/min	Più che sufficiente per conversazione IA umana
Pro	60 req/min	Più che sufficiente per conversazione IA umana
Business	600 req/min	Costruito per operazioni bulk scriptate
Prova 14 giorni	600 req/min	Equivalente Business durante la prova

Codici di errore

HTTP standard. Body sempre JSON: { error, message, request_id }.

401Header X-API-Key mancante o malformato

403Chiave API valida ma senza autorizzazione per questo endpoint

404Risorsa non trovata in questo negozio

409Conflict — la risorsa esiste già (solo POST mutations)

429Rate-limit superato — vedi header Retry-After

500Errore server — request_id è loggato, scrivi a help@etchify.app

Inventario tool MCP / REST

36 tool: 15 di lettura, 21 di scrittura. La tabella elenca i 15 tool di lettura. Stessi tool via OpenAPI, MCP-HTTP, MCP-stdio o REST diretta.

Tool	Scopo
list-products	Elenca tutti i prodotti configurati nel tuo negozio
get-product-config	Config dettagliata di un prodotto (materiali, modalità, dimensioni)
browse-templates	Filtra i modelli per prodotto, categoria o forma
list-materials	Libreria di tutti i materiali configurati
list-shapes	Libreria di tutte le forme custom
list-all-templates	Elenco piatto di tutti i modelli
health-check	Stato di salute e uptime del servizio
get-api-spec	Restituisce la spec OpenAPI inline
get-setup-guide	Walkthrough dei passaggi di configurazione rimanenti
diagnose-setup	Rileva configurazioni errate tra prodotti, materiali, forme
shop-info	Nome del negozio, piano, data di installazione, locale, valuta
list-orders	Gli ordini del negozio, dai più recenti — stato, prodotto, anteprima del design, file di produzione pronto
get-order	Un ordine nel dettaglio
get-shop-stats	Numeri d'uso dei tuoi clienti
show-image	Mostra un'immagine di design o di prodotto nella chat

Prova questi prompt

Chiedi al tuo bridge ChatGPT o Claude i dati Etchify — copia una riga, incollala nel tuo frontend AI, fatto. 36 tool: 15 di lettura, 21 di scrittura attivi sotto il cofano.

Analytics e insight

Strumenti di lettura

Quali materiali vendono meglio questo mese?

Con quale template i clienti convertono più spesso?

Qual è la mia quota di fatturato Etchify in questo trimestre?

Su quale materiale progetta la maggior parte dei clienti?

Ispeziona la libreria

Strumenti di lettura

Elenca tutti i materiali della categoria legno.

Quali prodotti usano la forma 'Coaster Round'?

Quali sono le impostazioni di produzione per il materiale 'Oak 6mm'?

Quali template non sono stati usati negli ultimi 30 giorni?

Configurazione e debugging

Diagnostica + strumenti di scrittura

Il mio cliente non riesce ad aggiungere il design al carrello — cosa potrebbe non funzionare?

Guidami nell'attivazione dell'export PDF/X-1a per la mia tipografia.

Imposta il metodo di produzione di questo prodotto su stampa.

Individua le chiavi API mal configurate nel mio configurazione.

Richiede l'AI Integration attiva. La tua IA modifica la configurazione direttamente — i prodotti già in vendita attendono la tua approvazione.

Integration Cookbook

Tre ricette per i negozi che integrano Etchify nei propri flussi — bulk-fetch via curl, push in tempo reale con il webhook nativo orders/create di Shopify, config del nodo HTTP di n8n. Ogni snippet gira sull'API REST (tutti i piani).

Bulk-fetch degli ordini personalizzati (curl)

Estrai nel tuo ERP tutti gli ordini personalizzati di un intervallo di date. Elimina import da tabelle e flussi CSV senza tool aggiuntivi.

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

Push in tempo reale con orders/create di Shopify

Gli ordini arrivano in Etchify tramite i webhook degli ordini di Shopify — non esiste un webhook Etchify separato da verificare. Per il tuo ERP, un servizio email o un bridge Slack, abbona il webhook orders/create di Shopify; contiene le cart-property di Etchify di ogni ordine.

Nodo HTTP Request di n8n

JSON drop-in per un workflow n8n. Recupera ogni ora i nuovi ordini personalizzati con header di autenticazione. Combinalo con uno schedule trigger e un output Notion / Airtable.

// 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" } } }
}

Gli snippet sono template di partenza — inserisci le tue chiavi API, i tuoi secret e i tuoi endpoint. Il push in tempo reale usa il webhook orders/create di Shopify (gratuito in ogni piano Shopify), che trasporta ogni cart-property di Etchify (_design_id, _design_url, _preview_url, misure come “Dimensions”; il materiale è nella variante) — nessuna configurazione lato Etchify necessaria.

Live: AI Write Tools + REST diretta

Push in tempo reale (Shopify-nativo)

Iscrivi il webhook orders/create di Shopify al tuo endpoint — ogni Etchify-cart-property (_design_id, _design_url, _preview_url, misure come “Dimensions”; il materiale è nella variante) viene consegnata automaticamente. Verifica HMAC via la firma standard di Shopify. Gratis in ogni piano Shopify.

AI Write Tools

21 tool di scrittura per agenti IA in ogni piano: enable-product, create-shape, set-brand-colors, upload-shop-logo, create-template, set-production-method, ecc. La tua IA modifica la configurazione direttamente — i prodotti già in vendita attendono la tua approvazione.

Changelog API

Breaking-change e nuovi endpoint sono tracciati nel changelog.

Vedi changelog →

Hai bisogno di aiuto?

Scrivi a help@etchify.app — i piani Pro e Business hanno routing prioritario.

help@etchify.app Torna all'Integrazione IA