Buscar productos por nombre
Reemplazado por
GET /api/register/event/search(register). El audience builder ahora coincide el nombre del producto directamente vía el filtro genéricoevent(type=buy_product) — sin el paso nombre→SKU. Este endpoint sigue funcionando, pero el caminoboughtSku/person_order_itemes legado (se elimina en el cutover).
Resuelve términos de texto libre del nombre del producto en el conjunto de
SKUs (skuRefId) que se vendieron con nombres que coinciden. Impulsa el
audience builder: los SKUs devueltos alimentan el filtro de audiencia
boughtSku en el register.
terms es texto libre — los términos separados por espacio se combinan con
AND (acepta string terms=a b o repetido terms[]=a&terms[]=b).
sandalia salto devuelve solo SKUs cuyo nombre contiene ambas palabras (en
la misma cadena). La coincidencia ignora mayúsculas y acentos (collation
utf8mb4_general_ci), así que tenis coincide con TÊNIS.
El nombre proviene de order_item.productName (un snapshot por línea — Guper
no tiene un catálogo de productos separado). El resultado se agrupa por
skuRefId; cada elemento trae un name representativo y el conteo de líneas
que coinciden (hits), ordenado por hits desc. Sin alcance de
interface — skuRefId es la referencia canónica de SKU de la organización.
Auth: signature RSA servicio-a-servicio (ver Internal › Integração ›
Signature). La organización se toma del contexto de la solicitud.
Ejemplo práctico
1. Buscar — encontrar los SKUs llamados "sandalia salto":
GET /api/order/product/search?terms=sandalia%20salto
{
"terms": ["sandalia", "salto"],
"total": 1,
"products": [
{ "sku": "47142", "name": "Sandalia Salto Alto 38", "hits": 14 }
]
}
2. Armar la audiencia — usar los sku devueltos en el filtro boughtSku
de la query de audiencia del register (aquí: compró en los últimos 3 meses):
[
["boughtSku", "in", { "list": ["47142"] }, { "int": 3 }]
]
Combina con otros filtros via AND — ej.: hombres que compraron: antepón
["gender","equals",{"string":"male"}], "AND",. Referencia completa de
boughtSku en Internal › Services › Register › Audiência por produto.
Try-it values populated from environment ACME (Demo)
Autenticación
Token
Send your user token in the x-guper-authorization header.