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

Taxonomías de producto

GET https://api.afer.pro/api/v1/product-taxonomies
Alias en castellano (v0, sigue operativo): 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.

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.

tipostring|integer
opcional
Solo las de este tipo: su tipoId o su nombre (marca, categoría).
busquedastring
opcional
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

200 · application/json
{
    "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"
            }
        ]
    }
}
Notas
  • 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 con tipo o busqueda.