Saltar al contenido
Consultas

links

Tus enlaces guardados a productos y categorías, con su URL vigente.

links devuelve tus enlaces a productos y categorías con su URL vigente, en el mismo orden. Úsala si guardas enlaces en tu propio contenido.

links(links: [StorefrontLinkInput!]!): [StorefrontLink!]

Argumentos

CampoTipoRegla
links[StorefrontLinkInput!]!Hasta 100 enlaces.
links[].urlString!La URL o la ruta guardada, de 1 a 2048 caracteres.
links[].referenceStorefrontLinkReferenceInputOpcional: type e id del recurso.

type es un StorefrontLinkKind: product, category, brand o collection.

  • Solo se actualizan los enlaces a productos y categorías. Los externos quedan igual.
  • Se conservan la query y el fragmento, como ?talla=m.
CampoTipoDescripción
urlString!La URL vigente.
referenceStorefrontLinkReferencetype e id del recurso al que apunta, o null.

Ejemplo

Links.graphql
query Links($links: [StorefrontLinkInput!]!) {
  links(links: $links) {
    url
    reference { type id }
  }
}
Terminal
curl --request POST "https://storefront.ecomiq.pe/graphql" \
  --header "Content-Type: application/json" \
  --header "x-Store-Domain: mi-tienda" \
  --data-binary '{
    "query": "query Links($links: [StorefrontLinkInput!]!) { links(links: $links) { url reference { type id } } }",
    "variables": { "links": [{ "url": "/products/polo-azul?talla=m" }] }
  }'
Respuesta
{
  "data": {
    "links": [
      {
        "url": "/products/polo-pima-azul?talla=m",
        "reference": { "type": "product", "id": "7204558912004322039" }
      }
    ]
  }
}

Errores

CódigoCausa
BAD_USER_INPUTMás de 100 enlaces, una URL vacía o de más de 2048 caracteres, o una referencia no válida.
NOT_FOUNDLa tienda ya no existe.
STORE_CONTEXT_REQUIREDx-Store-Domain falta o no corresponde a una tienda.

Equivalente REST

POST /v1/urls/links recibe { "links": [...] } y responde con los enlaces en links.

Última actualización:

En esta página