Consultas
seller
Obtiene el perfil público y las políticas de un vendedor mediante su slug.
Última actualización:
seller devuelve un vendedor visible en la tienda resuelta. Además de identidad y reputación, expone las políticas que pueden mostrarse en su vitrina.
Firma
seller(slug: String!): StorefrontSellerProfileDto!Argumentos
| Argumento | Tipo | Regla |
|---|---|---|
slug | String! | Obligatorio. Se recorta antes de buscar, no puede quedar vacío y admite hasta 100 caracteres. |
Campos
| Campo | Tipo | Descripción |
|---|---|---|
id | String! | ID público opaco del vendedor. |
name | String! | Nombre público. |
slug | String! | Slug público. |
logo | String | URL o referencia pública del logo. |
rating.average | Decimal! | Promedio público de calificación. |
rating.totalReviews | Int! | Total de reseñas consideradas. |
deliveryPolicy | String | Política pública de entrega, si fue configurada. |
privacyAndSecurityPolicy | String | Política pública de privacidad y seguridad, si fue configurada. |
Query
query Seller($slug: String!) {
seller(slug: $slug) {
id
name
slug
logo
rating {
average
totalReviews
}
deliveryPolicy
privacyAndSecurityPolicy
}
}{
"slug": "acme"
}cURL
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 rating { average totalReviews } deliveryPolicy privacyAndSecurityPolicy } }",
"variables": { "slug": "acme" }
}'Respuesta
{
"data": {
"seller": {
"id": "456",
"name": "Acme",
"slug": "acme",
"logo": null,
"rating": {
"average": 4.5,
"totalReviews": 10
},
"deliveryPolicy": "Entrega en 2 a 4 días hábiles.",
"privacyAndSecurityPolicy": null
}
}
}Errores
| Código | Cuándo ocurre |
|---|---|
BAD_USER_INPUT | slug está vacío o supera 100 caracteres. |
NOT_FOUND | El vendedor no existe o no es visible en la tienda. |
STORE_CONTEXT_REQUIRED | x-Store-Domain no permite resolver una tienda. |