Documentación API pública V1 — Trowel Developers

GET/api/public/v1/products

products:read

Parámetros

limitinteger1..200opcionalquery

Número máximo de elementos por página. Por defecto 50, máximo 200.

cursorstringopcionalquery

Cursor opaco para continuar desde la respuesta anterior.

modifiedSincedate-time localopcionalquery

Incluye registros creados o modificados después de esta fecha, interpretada en el timezone del tenant.

sortstringopcionalquery

Orden de los resultados. Antepón - para orden descendente.

code-codeshortDescription-shortDescriptionpurchasePrice-purchasePricesalePrice-salePricecreatedAt-createdAtmodifiedAt-modifiedAt

codestringopcionalquery

Código exacto.

activebooleanopcionalquery

Filtra por estado activo.

unitCodestringopcionalquery

Símbolo de unidad.

searchstringopcionalquery

Búsqueda textual.

Respuesta

200Página de productos.

PublicProduct

Producto

Representación pública de un producto de catálogo.

PropiedadTipoDescripción

idobligatoriouuidIdentificador interno estable.

codeobligatoriostringCódigo del producto.

shortDescriptionobligatoriostringNombre corto.

descriptionstring | nullDescripción ampliada.

unitCodestring | nullSímbolo de unidad.

purchasePricenumber | nullPrecio de compra de referencia.

purchasePriceDatedate-time | nullFecha del precio de compra.

salePricenumber | nullPrecio de venta.

activeobligatoriobooleanEstado activo.

createdAtobligatoriodate-timeFecha de creación.

modifiedAtobligatoriodate-timeÚltima modificación.

concurrencyTokenobligatoriostringToken opaco para control de concurrencia.

Ejemplo JSON

{
  "id": "14cc9848-f0c0-4457-9fd1-2b60dd46d6f3",
  "code": "MAT-001",
  "shortDescription": "Cemento",
  "unitCode": "kg",
  "purchasePrice": 0.25,
  "active": true,
  "createdAt": "2026-10-10T12:00:00",
  "modifiedAt": "2026-10-10T12:00:00",
  "concurrencyToken": "ct_product_example"
}

Ejemplo de respuesta

{
  "items": [
    {
      "id": "14cc9848-f0c0-4457-9fd1-2b60dd46d6f3",
      "code": "MAT-001",
      "shortDescription": "Cemento",
      "unitCode": "kg",
      "purchasePrice": 0.25,
      "active": true,
      "createdAt": "2026-10-10T12:00:00",
      "modifiedAt": "2026-10-10T12:00:00",
      "concurrencyToken": "ct_product_example"
    }
  ],
  "nextCursor": "eyJ2ZXJzaW9uIjoxLCJvZmZzZXQiOjUwfQ",
  "hasMore": true
}

Errores

400Solicitud incorrectaapplication/json

401Autenticación inválida o no proporcionadaapplication/json

403Permisos insuficientesapplication/json

404Recurso no encontradoapplication/json

409Conflicto con el estado actualapplication/json

410Recurso ya no disponibleapplication/json

422Error de validaciónapplication/json

429Límite de solicitudes excedidoapplication/json

Ver modelo de error

PublicApiError

Error de API

Formato estable de los errores públicos.

PropiedadTipoDescripción

statusobligatoriointegerCódigo HTTP.

codeobligatoriostringCódigo estable para tratamiento automático.

messageobligatoriostringMensaje legible.

correlationIdobligatoriostringIdentificador para soporte y trazabilidad.

currentConcurrencyTokenstring | nullToken actual cuando existe un conflicto.

validationErrorsobject<string,string[]>Errores agrupados por campo.

Ejemplo JSON

{
  "status": 422,
  "code": "validation_error",
  "message": "The request is invalid.",
  "correlationId": "01J9EXAMPLE",
  "validationErrors": {
    "unitCode": [
      "The unit does not exist."
    ]
  }
}