GuidesE-commerce

Tuto : lire et modifier une boutique avec l’API Admin GraphQL de Shopify

Par l’équipe Banzai LabsMis à jour le 2 min de lecture

query {products(first: 50) {nodes {titlevariants { sku price }}pageInfo { endCursor }}POSTAdminGraphQLDemander exactement les champs utiles, page par page
Une requête GraphQL demande à l’API Admin de Shopify exactement les champs utiles, par pages.

1. Le point d’accès

const URL = `https://${process.env.SHOP}.myshopify.com/admin/api/${process.env.API_VERSION}/graphql.json`;

async function gql(query: string, variables = {}) {
  const r = await fetch(URL, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json', 'X-Shopify-Access-Token': process.env.SHOPIFY_TOKEN! },
    body: JSON.stringify({ query, variables }),
  });
  const json = await r.json();
  if (json.errors) throw new Error(JSON.stringify(json.errors));
  return json.data;
}

2. Lire le catalogue, page par page

const Q = `query ($apres: String) {
  products(first: 50, after: $apres) {
    nodes { id title variants(first: 20) { nodes { id sku price } } }
    pageInfo { hasNextPage endCursor }
  }
}`;

let apres = null;
do {
  const { products } = await gql(Q, { apres });
  traiter(products.nodes);
  apres = products.pageInfo.hasNextPage ? products.pageInfo.endCursor : null;
} while (apres);

3. Modifier un prix

await gql(`mutation ($produit: ID!, $variantes: [ProductVariantsBulkInput!]!) {
  productVariantsBulkUpdate(productId: $produit, variants: $variantes) {
    userErrors { field message }
  }
}`, { produit: 'gid://shopify/Product/123', variantes: [{ id: 'gid://shopify/ProductVariant/456', price: '49.90' }] });

Vérifiez toujours userErrors : une mutation peut répondre sans erreur HTTP et n’avoir rien fait.

4. Les bonnes pratiques

  • Champs minimauxChaque champ demandé coûte.
  • Coût surveilléLire le crédit restant dans la réponse.
  • Opérations en massePour exporter tout un gros catalogue.

Comptoir, l’un de nos projets, s’appuie sur cette API pour modifier prix, stock et fiches sur plusieurs boutiques depuis une conversation avec Claude.

Le contexte : lancer une boutique Shopify. Une application : traduire un catalogue Shopify.

Questions fréquentes

Comment obtenir un jeton d’accès ?
En créant une application pour la boutique (selon votre compte, depuis l’administration ou le tableau de bord développeur de Shopify), avec uniquement les accès nécessaires, par exemple read_products et write_products.
Quelle version de l’API utiliser ?
Les versions sont datées et publiées chaque trimestre. Fixez-en une dans l’adresse et mettez-la à jour avant qu’elle ne soit retirée.
Pourquoi ma requête est-elle refusée pour limite ?
Shopify compte un coût par requête. La réponse indique le coût et le crédit restant : ralentissez quand il baisse, ou passez aux opérations en masse.

Les projets où on l’a fait

À lire ensuite

Tous les guides