GuíasE-commerce
Tutorial: leer y modificar una tienda con la API Admin GraphQL de Shopify
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.
