Saltar al contenido
Consultas

seller

Perfil de un vendedor por su slug: identidad, enlaces, calificación y políticas.

seller devuelve el perfil de un vendedor a partir de su slug, con lo necesario para su página: descripción, enlaces, calificación y políticas.

seller(slug: String!): StorefrontSellerProfileDto!

Argumentos

ArgumentoTipoRegla
slugString!Hasta 100 caracteres. Se recortan los espacios.

StorefrontSellerProfileDto

CampoTipoDescripción
idString!ID del vendedor.
nameString!Nombre.
slugString!Slug.
logoStringURL del logo.
bannerStringURL del banner.
taglineStringFrase corta.
verifiedBoolean!true si está verificado.
descriptionStringDescripción.
linksStorefrontSellerLinksDto!website, facebook, instagram, tikTok, youTube, twitter, linkedIn y whatsApp, todos String.
linkStyleSellerLinkStyle!ICONS o TEXT: cómo mostrar los enlaces.
memberSinceDateTime!Fecha de alta en el marketplace.
rating.averageDecimal!Calificación promedio.
rating.totalReviewsInt!Reseñas incluidas en el promedio.
deliveryPolicyStringPolítica de entrega.
privacyAndSecurityPolicyStringPolítica de privacidad y seguridad.

Ejemplo

Seller.graphql
query Seller($slug: String!) {
  seller(slug: $slug) {
    id
    name
    slug
    logo
    description
    links { website instagram whatsApp }
    linkStyle
    rating { average totalReviews }
    deliveryPolicy
    privacyAndSecurityPolicy
  }
}
Terminal
curl --request POST "https://storefront.ecomiq.pe/graphql" \
  --header "Content-Type: application/json" \
  --header "x-Store-Domain: mi-tienda" \
  --data-binary '{
    "query": "query Seller($slug: String!) { seller(slug: $slug) { id name slug logo description links { website instagram whatsApp } linkStyle rating { average totalReviews } deliveryPolicy privacyAndSecurityPolicy } }",
    "variables": { "slug": "acme" }
  }'
Respuesta
{
  "data": {
    "seller": {
      "id": "7204558912004325310",
      "name": "Acme",
      "slug": "acme",
      "logo": null,
      "description": "Menaje y cocina.",
      "links": { "website": "https://acme.pe", "instagram": null, "whatsApp": null },
      "linkStyle": "ICONS",
      "rating": { "average": 4.5, "totalReviews": 10 },
      "deliveryPolicy": "Entrega en 2 a 4 días hábiles.",
      "privacyAndSecurityPolicy": null
    }
  }
}

Errores

CódigoCausa
BAD_USER_INPUTslug vacío o de más de 100 caracteres.
NOT_FOUNDEl vendedor no existe en la tienda.
STORE_CONTEXT_REQUIREDx-Store-Domain falta o no corresponde a una tienda.

Equivalente REST

GET /v1/sellers/{slug} devuelve el mismo perfil.

Última actualización:

En esta página