Guía de tienda
Los endpoints de tienda devuelven el perfil del negocio y estadísticas de reviews resueltos desde la API key.
Endpoints
| Método | Ruta | Uso |
|---|---|---|
GET | /api/2026-04/shop | Consultar el perfil de tienda y su valoración agregada. |
GET | /api/2026-04/shop/stats | Consultar estadísticas de reviews, distribución de valoraciones y cobertura de producto. |
Perfil de tienda
Usa GET /api/2026-04/shop para confirmar a qué negocio resuelve la API key y mostrar información agregada de tienda.
bash
curl "https://api.revi.io/api/2026-04/shop" \
-H "Accept: application/json" \
-H "X-API-KEY: revi_test_xxxxxxxxx"Respuesta típica:
json
{
"success": true,
"data": {
"website": "example.com",
"avg_rating": "4.68",
"total_reviews": 7263,
"default_language": "en"
},
"meta": {
"api_version": "2026-04"
}
}Estadísticas de reviews
Usa GET /api/2026-04/shop/stats para dashboards y reporting periódico.
La respuesta incluye:
| Campo | Descripción |
|---|---|
avg_rating | Valoración media actual del negocio. |
total_reviews | Número total de reviews del negocio. |
rating_breakdown | Conteos agrupados por valoración, de 5 a 1 estrellas. |
reviews_by_type.shop | Número de reviews de tienda. |
reviews_by_type.product | Número de reviews de producto. |
products_with_reviews | Número de productos sincronizados con al menos una review. |
Caché
El perfil y las estadísticas de tienda pueden cachearse en cliente durante periodos cortos. Revi también puede cachear estos endpoints server-side, por lo que son adecuados para dashboards y comprobaciones de sincronización, no para decisiones transaccionales por request.