Guía de productos

Los productos permiten a Revi solicitar, organizar y mostrar reviews de producto. Los IDs de producto son IDs externos de tu plataforma de comercio.

Endpoints

Método	Ruta	Uso
GET	/api/2026-04/products	Listar productos sincronizados.
POST	/api/2026-04/products	Crear o actualizar productos en bloque.
GET	/api/2026-04/products/{id_product}	Consultar un producto por ID externo.
GET	/api/2026-04/products/{id_product}/reviews	Listar reviews de un producto.

Crear o actualizar productos

Conserva los códigos de idioma completos tanto en lang como en locale[].lang. En particular, pt-BR y zh-Hant son distintos de pt y zh. Revi normaliza pt_BR a pt-BR y zh_TW a zh-Hant cuando esos códigos están disponibles. La resolución puede recurrir al código base disponible o al idioma predeterminado del negocio si no hay ningún candidato disponible. Usa en las consultas posteriores el código que devuelve Revi.

Cada producto requiere id_product con 36 caracteres o menos. Envía entradas locale cuando los nombres o URLs del producto cambien por idioma.

Los campos de entrada soportados a nivel superior son id_product, lang, name, description, description_short, url, photo_url, price, currency, stock, allow_out_of_stock_orders, ean, sku, upc, jan, isbn, mpn, brand, locale y combinations.

curl "https://api.revi.io/api/2026-04/products" \
  -X POST \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: revi_test_xxxxxxxxx" \
  -d '{
    "products": [
      {
        "id_product": "sku-123",
        "price": "29.90",
        "currency": "EUR",
        "stock": 20,
        "ean": "8430000000000",
        "sku": "RUN-RED-42",
        "brand": "ExampleBrand",
        "locale": [
          {
            "lang": "en",
            "name": "Running shoe",
            "description": "Lightweight running shoe.",
            "url": "https://example.com/products/running-shoe",
            "photo_url": "https://example.com/images/running-shoe.jpg"
          }
        ],
        "combinations": [
          {
            "id_combination": "sku-123-red-42",
            "sku": "RUN-RED-42",
            "photo_url": "https://example.com/images/running-shoe-red.jpg"
          }
        ]
      }
    ]
  }'

Las respuestas batch incluyen un resultado por producto:

{
  "success": true,
  "data": {
    "products_count": 1,
    "results": [
      {
        "id_product": "sku-123",
        "success": true
      }
    ]
  },
  "meta": {
    "api_version": "2026-04"
  }
}

Si todas las filas fallan validación o procesamiento, la API devuelve 422 con los results por fila dentro de error.details.

Idiomas

Cada item de locale requiere:

Campo	Obligatorio	Descripción
lang	Sí	Código de idioma del producto.
name	Sí	Nombre del producto en ese idioma.
description	No	Descripción completa del producto.
description_short	No	Descripción corta del producto.
url	No	URL pública del producto.
photo_url	No	URL de imagen del producto.

Combinaciones

Usa combinations para variantes. Cada combinación requiere id_combination con 50 caracteres o menos.

Los campos soportados en combinaciones incluyen ean, sku, upc, jan, isbn, mpn, brand y photo_url.

Listar productos

Filtros soportados:

Filtro	Descripción
page	Número de página, empezando en 1.
per_page	Tamaño de página, de 1 a 100. Por defecto es 25.
search	Busca en nombres de producto localizados.
has_reviews	Booleano. true devuelve productos con reviews; false devuelve productos sin reviews.
sort	created_desc, rating_desc, rating_asc o reviews_desc.

Las respuestas de listado devuelven filas compactas de catálogo: id_product, id_store, avg_rating, num_reviews, ean, sku, brand, price y stock.

Leer un producto

GET /api/2026-04/products/{id_product} devuelve los campos compactos del producto junto con locale y combinations. Las entradas de idioma incluyen lang, name, description, url y photo_url. Las combinaciones incluyen id_combination, ean, sku, upc, brand y photo_url.

Reviews de producto

Usa GET /api/2026-04/products/{id_product}/reviews para recuperar reviews de un producto.

Filtros soportados:

Filtro	Descripción
page	Número de página, empezando en 1.
per_page	Tamaño de página, de 1 a 100. Por defecto es 25.
rating	Coincidencia exacta de valoración.
sort	date_desc o date_asc.

Las filas de reviews devueltas por este endpoint son más pequeñas que las reviews globales. Incluyen id, id_order, customer_name, customer_lastname, comment, rating, lang y date.