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

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|integer
obligatorio
Producto a clasificar.
familiaIdstring|integer
opcional
Familia que se le pone.
taxonomiasarray
opcional
Lista de taxonomiaId que se le añaden.
quitararray
opcional
Lista de taxonomiaId que se le quitan.
reemplazarboolean
opcional
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, taxonomias ni quitar responde 400: no se ha pedido ningún cambio.