Saltar al contenido
docs
Guías
EN
CatálogoProductos
catalog:read

Listar actividad del producto

Devuelve el historial de auditoría de un producto: qué cambió, cuándo y quién lo cambió.

GET/v1/catalog/products/{productId}/activity

Devuelve el historial de auditoría de un producto: qué cambió, cuándo y quién lo cambió.

Autorización

bearerAuth
AutorizaciónBearer <token>

Token de acceso OAuth 2.0 emitido por Ecomiq Auth.

Ubicación: header

Parámetros de ruta

productId*string

Identificador del producto.

Parámetros de consulta

limit?integer

Cantidad máxima de resultados por devolver.

Formatoint32
cursor?string

Cursor opaco de la respuesta anterior. Omítelo en la primera página.

search?string

Filtro de texto libre. Los campos consultados dependen del recurso.

sortBy?string

Campo de ordenamiento. Los valores admitidos dependen del recurso.

sortDirection?string

Dirección del ordenamiento: asc o desc.

Valor en

  • "asc"
  • "desc"
variantId?string

Identificador de la variante.

locationId?string

Identificador de la ubicación.

source?string

Origen de los datos.

Valor en

  • "product"
  • "price"
  • "inventory"

Parámetros de cabecera

x-Store-Id?string

Tienda sobre la que actúa la solicitud. No hace falta cuando el token ya está vinculado a una tienda.

Authorization*string

Token bearer OAuth 2.0.

Cuerpo de la respuesta

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/v1/catalog/products/7204558912004325301/activity" \  -H "x-Store-Id: <store-id>" \  -H "Authorization: Bearer <token>"
{  "data": [    {      "id": "7204558912004325301",      "source": "product",      "action": "example",      "timestamp": "2026-08-01T15:30:00Z",      "userId": "2f40d7e4-3d9c-4ab2-b04e-7a6a132db821",      "userEmail": "andrea@example.com",      "userName": "Example resource",      "actorSource": "example",      "clientId": "app_replace_with_your_client_id",      "entityName": "Comercial Lima SAC",      "productId": "7204558912004325301",      "variantId": "7204558912004325301",      "variantName": "Example resource",      "sku": "SKU-001",      "locationId": "7204558912004325301",      "locationName": "Example resource",      "reason": "Example note.",      "referenceKind": "transfer",      "referenceId": "7204558912004325301",      "changes": [        {          "field": "example",          "before": "example",          "after": "example"        }      ]    }  ],  "hasNextPage": false,  "nextCursor": "example",  "totalCount": 1}