Taxonomías
API para el tratamiento taxonomías.
Vista de una taxonomía
GET /api/taxonomies/:id
La vista default de taxonomías devuelve la info de taxones sólo de los hijos directos. Si queremos tener el árbol completo, con todos los hijos de los hijos se puede usar:
GET /api/taxonomies/:id?set=admin_mini&view=admin mini
Con esos parámetros vamos a tener la información mínima de cada taxon del árbol (id, name).
Creación
POST /api/taxonomies
Body:
{
"taxonomy": {
"name": "Promociones",
"public": true
}
}
Si la creación fue exitosa, la respuesta es la vista de la taxonomía creada, que contiene el id del mismo, necesario para posteriores modificaciones y para crear taxones en ese árbol.
Al crear una taxonomía, se crea también el taxon raíz de dicho árbol. Todos los taxones creados posteriormente van a ser hijos de este. La api devuelve la info del mismo en la key root.
Respuesta:
{
"id": 145,
"name": "Promociones",
"public": true,
"root": {
"id": 7487,
"name": "Promociones",
"pretty_name": "Promociones",
"permalink": "promociones",
"parent_id": null,
"taxonomy_id": 145,
"image_link": null,
"description": null,
"starred": false,
"meta_title": null,
"meta_description": null,
"meta_keywords": null,
"position": 0,
"public": true,
"complete_permalink": "https://clastia.com.ar/promociones/7487",
"taxons": []
},
"app": {
"id": 8,
"name": "clastia"
}
}
Update
PUT /api/taxonomies/:id
Body:
{
"taxonomy": {
"name": "New name",
"public": false
}
}
Delete
DELETE /api/taxonomies/:id
Atención: Tener en cuanta que el borrado de una taxonomía, implica el borrado de todo el árbol; es decir de todos sus taxones hijos.
Aclaración: Tanto la taxonomía como el taxon no podrá ser borrado si existe algún producto que lo está usando.