Taxonomías de producto
https://api.afer.pro/api/v1/product-taxonomies
POST https://api.afer.pro/consultarTaxonomias
Las taxonomías de producto de tu cuenta —marcas, categorías y los demás tipos— con cuántos productos lleva cada una.
Una taxonomía clasifica productos y, a diferencia de la familia, un mismo artículo puede llevar varias y de distintos tipos: una marca, dos categorías…
La respuesta trae también el catálogo de tipos (tipos). Míralo antes de crear nada: los tipos son comunes a todas las cuentas y no se crean desde la API, se eligen.
Da los taxonomiaId que aceptan crearProducto, etiquetarProducto y consultarVentasPorTaxonomia.
Envía tus claves API en las cabeceras X-API-KEY y X-API-SECRET. La cuenta sobre la que se opera se resuelve automáticamente a partir de la clave. Cómo obtener tus claves →
Este endpoint requiere autenticación con API key: sin credenciales responde 401.
Parámetros del cuerpo
El cuerpo de la petición es un objeto JSON con Content-Type: application/json.
tipostring|integeropcional | Solo las de este tipo: su tipoId o su nombre (marca, categoría). |
busquedastringopcional | Texto a buscar en el nombre de la taxonomía. |
Ejemplo de petición
curl -X GET 'https://api.afer.pro/api/v1/product-taxonomies?tipo=marca' \
-H 'X-API-KEY: afer_tk_TU_TOKEN' \
-H 'X-API-SECRET: afer_sk_TU_SECRET'
<?php
$ch = curl_init('https://api.afer.pro/api/v1/product-taxonomies?tipo=marca');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'X-API-KEY: afer_tk_TU_TOKEN',
'X-API-SECRET: afer_sk_TU_SECRET',
]);
$respuesta = json_decode(curl_exec($ch), true);
curl_close($ch);
const respuesta = await fetch('https://api.afer.pro/api/v1/product-taxonomies?tipo=marca', {
method: 'GET',
headers: {
'X-API-KEY': 'afer_tk_TU_TOKEN',
'X-API-SECRET': 'afer_sk_TU_SECRET'
}
});
const resultado = await respuesta.json();
Respuesta
{
"errorCode": 200,
"errorMsg": "",
"data": {
"total_taxonomias": 2,
"taxonomias": [
{
"taxonomiaId": "aBc123…",
"titulo": "Bosch",
"tipoId": 11,
"tipo": "Marca",
"num_productos": 48
},
{
"taxonomiaId": "dEf456…",
"titulo": "Makita",
"tipoId": 11,
"tipo": "Marca",
"num_productos": 31
}
],
"tipos": [
{
"tipoId": 3,
"titulo": "Categoría"
},
{
"tipoId": 11,
"titulo": "Marca"
}
]
}
}
- Una taxonomía puede colgar de otra del mismo tipo: en ese caso trae
padreId. - El recuento cuenta solo artículos de tu cuenta.
- Si hay más de 500 términos la lista se corta y la respuesta lo dice en
aviso: acota contipoobusqueda.