GuíasE-commerce

Tutorial: leer y modificar una tienda con la API Admin GraphQL de Shopify

Por el equipo de Banzai LabsActualizado el 2 min de lectura

query {products(first: 50) {nodes {titlevariants { sku price }}pageInfo { endCursor }}POSTAdminGraphQLPedir exactamente los campos útiles, página a página
Una consulta GraphQL pide a la API Admin de Shopify exactamente los campos útiles, por páginas.

1. El punto de acceso

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. Leer el catálogo, página a página

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

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

3. Cambiar un precio

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

Comprueba siempre userErrors: una mutación puede responder sin error HTTP y no haber hecho nada.

4. Buenas prácticas

  • Campos mínimosCada campo pedido tiene un coste.
  • Coste vigiladoLeer el crédito restante en la respuesta.
  • Operaciones masivasPara exportar todo un catálogo grande.

Comptoir, uno de nuestros proyectos, se apoya en esta API para cambiar precios, stock y fichas en varias tiendas desde una conversación con Claude.

El contexto: lanzar una tienda Shopify. Una aplicación: traducir un catálogo Shopify.

Preguntas frecuentes

¿Cómo obtengo un token de acceso?
Creando una aplicación para la tienda (según tu cuenta, desde la administración o el panel de desarrolladores de Shopify), solo con los permisos necesarios, por ejemplo read_products y write_products.
¿Qué versión de la API uso?
Las versiones llevan fecha y salen cada trimestre. Fija una en la URL y actualízala antes de que la retiren.
¿Por qué se rechaza mi consulta por límite?
Shopify asigna un coste a cada consulta. La respuesta indica el coste y el crédito restante: ve más despacio cuando baja, o pasa a las operaciones masivas.

Proyectos donde lo hicimos

Para leer después

Todas las guías