Base URL https://api.afer.pro Referencia aferapp.com Reservar demo

Crear taxonomía

POST https://api.afer.pro/api/v1/product-taxonomies
Alias en castellano (v0, sigue operativo): POST https://api.afer.pro/crearTaxonomia

Crea una taxonomía de producto (una marca, una categoría…) del tipo que le digas.

El tipo es obligatorio y tiene que ser uno de los que devuelve consultarTaxonomias: los tipos no se crean desde la API, porque el catálogo es común a todas las cuentas.

Con padreId la taxonomía cuelga de otra del mismo tipo (una categoría dentro de otra categoría).

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.

titulostring
obligatorio
Nombre de la taxonomía, p. ej. Bosch.
tipostring|integer
obligatorio
Tipo al que pertenece: su tipoId o su nombre (marca, categoría).
padreIdstring|integer
opcional
Taxonomía de la que cuelga. Tiene que ser del mismo tipo y de tu cuenta.

Ejemplo de petición

curl -X POST 'https://api.afer.pro/api/v1/product-taxonomies' \
  -H 'X-API-KEY: afer_tk_TU_TOKEN' \
  -H 'X-API-SECRET: afer_sk_TU_SECRET' \
  -H 'Content-Type: application/json' \
  -d '{
    "titulo": "Bosch",
    "tipo": "marca"
}'
<?php

$data = [
  'titulo' => 'Bosch',
  'tipo' => 'marca',
];

$ch = curl_init('https://api.afer.pro/api/v1/product-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/product-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({
      "titulo": "Bosch",
      "tipo": "marca"
  })
});

const resultado = await respuesta.json();

Respuesta

200 · application/json
{
    "errorCode": 200,
    "errorMsg": "",
    "data": {
        "taxonomiaId": "aBc123…",
        "titulo": "Bosch",
        "tipoId": 11,
        "tipo": "Marca",
        "num_productos": 0,
        "ya_existia": false
    }
}
Notas
  • No duplica: si ya existe un término con ese nombre y ese tipo devuelve el que había con ya_existia: true. La comparación ignora mayúsculas y acentos.
  • Admite la cabecera X-IDEMPOTENCY-KEY.
  • Un tipo que no exista responde 400 diciendo cuáles hay.