Listar categorías

curl --request GET \
  --url 'https://sandbox.external.cashea.app/v2/inventory/categories?limit=5' \
  --header 'Authorization: ApiKey TU_API_KEY'

{
  "data": [
    { "uuid": "49cba8d2-613d-4d35-b4cb-11968d1ba6fc", "name": "Estética y Belleza", "parentUuid": null, "hasChildren": true },
    { "uuid": "67f9fa1e-fc53-4cd1-9e18-2b92a1fc82f3", "name": "Tecnología", "parentUuid": null, "hasChildren": true }
  ],
  "pagination": { "offset": 0, "limit": 5, "total": 2346, "hasMore": true }
}

GET

https://sandbox.external.cashea.app

inventory

categories

curl --request GET \
  --url 'https://sandbox.external.cashea.app/v2/inventory/categories?limit=5' \
  --header 'Authorization: ApiKey TU_API_KEY'

{
  "data": [
    { "uuid": "49cba8d2-613d-4d35-b4cb-11968d1ba6fc", "name": "Estética y Belleza", "parentUuid": null, "hasChildren": true },
    { "uuid": "67f9fa1e-fc53-4cd1-9e18-2b92a1fc82f3", "name": "Tecnología", "parentUuid": null, "hasChildren": true }
  ],
  "pagination": { "offset": 0, "limit": 5, "total": 2346, "hasMore": true }
}

Devuelve el árbol de categorías del marketplace. Se usa para navegar el árbol (drill-down con parentUuid) o buscar por nombre (name), y así elegir la categoría con la que se clasificará un producto.

Las categorías no incluyen sus atributos en este endpoint; para eso usa GET /v2/inventory/categories/{uuid}.

Authorization

string

requerido

Formato: ApiKey TU_API_KEY

Query Parameters

string

uuid de una categoría. Devuelve solo sus hijos directos. Si se omite, devuelve el árbol completo (plano).

string

Filtra categorías por nombre. Máximo 256 caracteres.

integer

predeterminado:"50"

Resultados por página. Máximo 200.

integer

predeterminado:"0"

Resultados a saltar (paginación).

Response

array

Lista de categorías.

Mostrar categoría

string

uuid de la categoría.

string

Nombre de la categoría.

string | null

uuid de la categoría padre, o null si es una categoría raíz.

boolean

Si la categoría tiene subcategorías. Las categorías con hasChildren: false son hoja y son las únicas que se pueden asignar a un producto.

object

Mostrar paginación

integer

boolean

Errors

Código	Descripción
`400`	Parámetros inválidos (por ejemplo, `limit` mayor a 200).

curl --request GET \
  --url 'https://sandbox.external.cashea.app/v2/inventory/categories?limit=5' \
  --header 'Authorization: ApiKey TU_API_KEY'

{
  "data": [
    { "uuid": "49cba8d2-613d-4d35-b4cb-11968d1ba6fc", "name": "Estética y Belleza", "parentUuid": null, "hasChildren": true },
    { "uuid": "67f9fa1e-fc53-4cd1-9e18-2b92a1fc82f3", "name": "Tecnología", "parentUuid": null, "hasChildren": true }
  ],
  "pagination": { "offset": 0, "limit": 5, "total": 2346, "hasMore": true }
}

Primeros pasos

APIs

Authorization

Query Parameters

Response

Errors

​Authorization

​Query Parameters

​Response

​Errors

Authorization

Query Parameters

Response

Errors