Crear familia de artículos
POST
https://api.afer.pro/api/v1/product-categories
Alias en castellano (v0, sigue operativo):
POST https://api.afer.pro/crearFamilia
Da de alta una familia de artículos.
La familia es la clasificación principal del catálogo y es una por artículo. Para las clasificaciones que admiten varias a la vez, usa las taxonomías.
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.
titulostringobligatorio | Nombre de la familia, p. ej. Ferretería. |
Ejemplo de petición
curl -X POST 'https://api.afer.pro/api/v1/product-categories' \
-H 'X-API-KEY: afer_tk_TU_TOKEN' \
-H 'X-API-SECRET: afer_sk_TU_SECRET' \
-H 'Content-Type: application/json' \
-d '{
"titulo": "Ferretería"
}'
<?php
$data = [
'titulo' => 'Ferretería',
];
$ch = curl_init('https://api.afer.pro/api/v1/product-categories');
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/product-categories', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-KEY': 'afer_tk_TU_TOKEN',
'X-API-SECRET': 'afer_sk_TU_SECRET'
},
body: JSON.stringify({
"titulo": "Ferretería"
})
});
const resultado = await respuesta.json();
Respuesta
200 · application/json
{
"errorCode": 200,
"errorMsg": "",
"data": {
"familiaId": "dEf456…",
"titulo": "Ferretería",
"ya_existia": false
}
}
Notas
- No duplica: si ya existe una familia con ese nombre devuelve la que había con
ya_existia: true. La comparación ignora mayúsculas y acentos. - Admite la cabecera
X-IDEMPOTENCY-KEY. - El listado está en consultarFamilias.