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
| Campo | Tipo | Regla |
|---|---|---|
links | [StorefrontLinkInput!]! | Hasta 100 enlaces. |
links[].url | String! | La URL o la ruta guardada, de 1 a 2048 caracteres. |
links[].reference | StorefrontLinkReferenceInput | Opcional: 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.
StorefrontLink
| Campo | Tipo | Descripción |
|---|---|---|
url | String! | La URL vigente. |
reference | StorefrontLinkReference | type e id del recurso al que apunta, o null. |
Ejemplo
query Links($links: [StorefrontLinkInput!]!) {
links(links: $links) {
url
reference { type id }
}
}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" }] }
}'{
"data": {
"links": [
{
"url": "/products/polo-pima-azul?talla=m",
"reference": { "type": "product", "id": "7204558912004322039" }
}
]
}
}Errores
| Código | Causa |
|---|---|
BAD_USER_INPUT | Más de 100 enlaces, una URL vacía o de más de 2048 caracteres, o una referencia no válida. |
NOT_FOUND | La tienda ya no existe. |
STORE_CONTEXT_REQUIRED | x-Store-Domain falta o no corresponde a una tienda. |
Equivalente REST
POST / recibe { "links": [...] } y responde con los enlaces en links.
Última actualización: