Clasificar un producto
POST
https://api.afer.pro/api/v1/products/{id}/taxonomies
Alias en castellano (v0, sigue operativo):
POST https://api.afer.pro/etiquetarProducto
Pone o quita la familia y las taxonomías de un producto que ya existe.
Por defecto las taxonomías de taxonomias se suman a las que el producto ya tenía. Con reemplazar: true pasan a ser las únicas: lo que no esté en la lista se suelta.
Repetir la llamada no duplica nada: un artículo no puede llevar dos veces la misma etiqueta.
Autenticación
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.
articuloIdstring|integerobligatorio | Producto a clasificar. |
familiaIdstring|integeropcional | Familia que se le pone. |
taxonomiasarrayopcional | Lista de taxonomiaId que se le añaden. |
quitararrayopcional | Lista de taxonomiaId que se le quitan. |
reemplazarbooleanopcional | Si es true, las de taxonomias pasan a ser las únicas del producto. Por defecto false. |
Ejemplo de petición
curl -X POST 'https://api.afer.pro/api/v1/products/aBc123XyZ/taxonomies' \
-H 'X-API-KEY: afer_tk_TU_TOKEN' \
-H 'X-API-SECRET: afer_sk_TU_SECRET' \
-H 'Content-Type: application/json' \
-d '{
"articuloId": "gHi789…",
"familiaId": "dEf456…",
"taxonomias": [
"aBc123…"
]
}'
<?php
$data = [
'articuloId' => 'gHi789…',
'familiaId' => 'dEf456…',
'taxonomias' => [
0 => 'aBc123…',
],
];
$ch = curl_init('https://api.afer.pro/api/v1/products/aBc123XyZ/taxonomies');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
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',
'Content-Type: application/json',
]);
$respuesta = json_decode(curl_exec($ch), true);
curl_close($ch);
const respuesta = await fetch('https://api.afer.pro/api/v1/products/aBc123XyZ/taxonomies', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-KEY': 'afer_tk_TU_TOKEN',
'X-API-SECRET': 'afer_sk_TU_SECRET'
},
body: JSON.stringify({
"articuloId": "gHi789…",
"familiaId": "dEf456…",
"taxonomias": [
"aBc123…"
]
})
});
const resultado = await respuesta.json();
Respuesta
200 · application/json
{
"errorCode": 200,
"errorMsg": "",
"data": {
"articuloId": "gHi789…",
"descripcion": "Taladro percutor 750W",
"familia": {
"familiaId": "dEf456…",
"titulo": "Ferretería"
},
"taxonomias": [
{
"taxonomiaId": "aBc123…",
"titulo": "Bosch",
"tipoId": 11,
"tipo": "Marca"
}
],
"puestas": 1,
"quitadas": 0
}
}
Notas
- Devuelve cómo queda clasificado el producto, no solo lo que ha cambiado.
- Admite la cabecera
X-IDEMPOTENCY-KEY. - Sin
familiaId,taxonomiasniquitarresponde400: no se ha pedido ningún cambio.