Construis avec Etchify.

Intégration IA et API REST directe dans tous les plans, essai inclus. Spec OpenAPI, endpoint MCP, 36 outils : 15 en lecture, 21 en écriture. Push temps réel via le webhook orders/create natif de Shopify.

Quickstarts

Choisis le frontend que tu utilises déjà. Chaque configuration commence par la clé API de l’admin Etchify.

Tous les plans, essai inclus

Endpoints

Tous les endpoints sont scopés à une boutique unique via la clé API.

Spécification OpenAPI

Importe cette URL dans les Actions de ChatGPT Custom GPT ou génère un client typé.

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

Ouvrir →

Endpoint MCP

Utilise cette URL pour les connecteurs custom Claude.ai et la config mcpServers de Claude Desktop / Claude Code.

https://api.etchify.app/mcp

Authentification

Chaque requête a besoin d'un header.

X-API-Key: sk_etch_...

✓Rotation ou révocation à tout moment depuis Paramètres → Intégration IA dans l'admin Etchify.
✓Chaque clé est scopée à une boutique. Les clés ne quittent jamais ton admin Shopify avant que tu les copies — elles sont affichées une seule fois à la génération.

Rate-limits

Starter	60 req/min	Largement suffisant pour la conversation IA humaine
Pro	60 req/min	Largement suffisant pour la conversation IA humaine
Business	600 req/min	Conçu pour les opérations bulk scriptées
Essai 14 jours	600 req/min	Équivalent Business pendant l'essai

Codes d'erreur

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

401Header X-API-Key manquant ou malformé

403Clé API valide mais sans autorisation pour cet endpoint

404Ressource introuvable dans cette boutique

409Conflict — ressource existe déjà (POST mutations uniquement)

429Rate-limit dépassé — voir le header Retry-After

500Erreur serveur — request_id loggué, écris à help@etchify.app

Inventaire des outils MCP / REST

36 outils : 15 en lecture, 21 en écriture. Le tableau liste les 15 outils de lecture. Mêmes outils via OpenAPI, MCP-HTTP, MCP-stdio ou REST direct.

Outil	Objectif
list-products	Liste tous les produits configurés de ta boutique
get-product-config	Config détaillée d'un produit (matériaux, modes, dimensions)
browse-templates	Filtre les modèles par produit, catégorie ou forme
list-materials	Bibliothèque de tous les matériaux configurés
list-shapes	Bibliothèque de toutes les formes custom
list-all-templates	Liste plate de tous les modèles toutes catégories
health-check	Statut de santé et uptime du service
get-api-spec	Renvoie la spec OpenAPI inline
get-setup-guide	Walkthrough des étapes de configuration restantes
diagnose-setup	Détecte les mauvaises configurations entre produits, matériaux, formes
shop-info	Nom de la boutique, plan, date d'install, locale, devise
list-orders	Les commandes de la boutique, les plus récentes en premier — statut, produit, aperçu du design, fichier de production prêt
get-order	Une commande en détail
get-shop-stats	Chiffres d'utilisation de tes clients
show-image	Affiche une image de design ou de produit dans le chat

Essaie ces prompts

Demande des données Etchify à ton pont ChatGPT ou Claude — copie une ligne, colle-la dans ton frontend IA, c'est fait. 36 outils : 15 en lecture, 21 en écriture tournent sous le capot.

Analytics & insights

Outils de lecture

Quels matériaux se vendent le mieux ce mois-ci ?

Avec quel modèle les clients convertissent-ils le plus souvent ?

Quelle est ma part de chiffre d'affaires Etchify ce trimestre ?

Sur quel matériau la plupart des clients créent-ils ?

Inspecter la bibliothèque

Outils de lecture

Liste tous les matériaux de la catégorie bois.

Quels produits utilisent la forme « Coaster Round » ?

Quels sont les réglages de production pour le matériau « Chêne 6mm » ?

Quels modèles n'ont pas été utilisés au cours des 30 derniers jours ?

Configuration & débogage

Outils de diagnostic + d'écriture

Mon client n'arrive pas à ajouter le design au panier — qu'est-ce qui pourrait clocher ?

Guide-moi pour activer l'export PDF/X-1a pour mon imprimerie.

Passe le procédé de ce produit en impression.

Repère les clés API mal configurées dans ma configuration.

Nécessite l'Intégration IA activée. Ton IA modifie la configuration directement — les produits déjà en vente attendent ton approbation.

Integration Cookbook

Trois recettes pour les propriétaires qui branchent Etchify sur leurs propres workflows — récupération en masse via curl, push en temps réel via le webhook natif orders/create de Shopify, config du nœud HTTP n8n. Chaque snippet s'appuie sur l'API REST (tous les plans).

Récupération en masse des commandes personnalisées (curl)

Récupère toutes les commandes personnalisées d'une période dans ton ERP. Supprime les imports de tableaux et les workflows CSV, sans outil supplémentaire.

# 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 en temps réel via orders/create de Shopify

Les commandes arrivent dans Etchify via les webhooks de commande propres à Shopify — il n'existe pas de webhook Etchify séparé à vérifier. Pour ton ERP, un service d'e-mail ou une passerelle Slack, abonne le webhook orders/create de Shopify ; il contient les propriétés de panier Etchify de chaque commande.

Nœud HTTP Request n8n

JSON prêt à l'emploi pour un workflow n8n. Récupère les nouvelles commandes personnalisées toutes les heures avec un en-tête d'authentification. À combiner avec un déclencheur planifié et une sortie 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" } } }
}

Les snippets sont des modèles de départ — remplace par tes propres clés API, secrets et endpoints. Le push en temps réel utilise le webhook orders/create de Shopify (gratuit dans tous les plans Shopify), qui transporte chaque propriété de panier Etchify (_design_id, _design_url, _preview_url, dimensions sous « Dimensions » ; le matériau est dans la variante) — aucune configuration côté Etchify nécessaire.

En direct : AI Write Tools + REST directe

Push temps réel (Shopify-natif)

Abonne le webhook orders/create de Shopify à ton endpoint — chaque Etchify-cart-property (_design_id, _design_url, _preview_url, dimensions sous « Dimensions » ; le matériau est dans la variante) est livrée automatiquement. Vérification HMAC via la signature standard Shopify. Gratuit dans chaque plan Shopify.

AI Write Tools

21 outils en écriture pour agents IA dans tous les plans : enable-product, create-shape, set-brand-colors, upload-shop-logo, create-template, set-production-method, etc. Ton IA modifie la configuration directement — les produits déjà en vente attendent ton approbation.

Changelog API

Breaking-changes et nouveaux endpoints sont trackés dans le changelog.

Voir le changelog →

Besoin d'aide ?

Écris à help@etchify.app — les plans Pro et Business ont un routing prioritaire.

help@etchify.app Retour à l'intégration IA