Clasificaciones

El arbol de clasificaciones es jerárquico. Cada clasificación tiene un padre y puede tener hijos.
Las clasificaciones de primer nivel no tienen padre, pero sí tienen una familia a las cuales pertenecen.
Para recuperar una clasificación en particular hay tres recursos disponibles en el objeto clasificacion:
data: contiene los datos básicos de la clasificación
hijos: contiene la lista de las clasificaciones de primer nivel en esta clasificación
landpage: contiene los datos completos del landpage de la clasificación

Recurso 'data'

Los datos básicos de una clasificación se obtienen consumiendo el recurso siguiente:
[GET] /clasificacion/:Clave/data.json
:Clave es la clave del recurso solicitado.

El sistema regresará los datos de la clasificación solicitada:
{
  "clave":1,
  "familia":"rec",
  "padre":null,
  "orden":1,
  "estatus":1,
  "nombre":"Postres",
  "titulo":"Recetas de Postres",
  "link":"postres",
  "palabras":"\u00bfEst\u00e1s buscando recetas de Postres? Kiwilimon tiene las mejores recetas de pasteles, pays y gelatinas probadas con calificaciones, comentarios, tips y videos.",
  "destacada":0,
  "imagentitulo":"Recetas de Postres",
  "imagen":"1.jpg",
  "extra1":"",
  "extra2":"",
  "extra3":"",
  "extra4":"",
  "extra5":"",
  "lastmodif":"2013-04-18T13:32:46.00-06",
  "lastuser":9,
  "ruta":"\/recetas\/postres",
  "cantidadsubclasificaciones":15,
  "cantidadrecetas":"1615"
}
Los campos a considerar son:
clave: la clave interna de referencia de la clasificación en el GRAPH.
estatus: el estatus de la clasificación. Siempre será 1 ya que solo las clasificaciones publicadas son visibles en el GRAPH.
nombre: el nombre de la clasificación.
titulo: el titulo usado para H1 en la página.
palabras: es la descripción usada para los metatags de la página.
link: es el link unico la clave al grupo USDA descrito en el capítulo anterior.
pasilloingrediente: es la clave al pasillo descrito en el capítulo anterior.
cantidadrecetas: es la cantidad de recetas que usan este ingrediente.

Recurso 'hijos'

Los datos básicos agregados de las clasificaciones hijas de una familia se obtienen consumiendo el recurso siguiente:
[GET] /familia/:Clave/hijos.json
:Clave es la clave del recurso solicitado.

El sistema regresará los datos de la familia solicitada con el arregle de clasificaciones hijas:
{ FAMILIA,
  "clasificaciones":
  [
    {CLASIFICACION-1},  
    {CLASIFICACION-2},  
    ...
  ]
}
FAMILIA es el arreglo de la familia básica.
{CLASIFICACION-n} representa el objecto básico data de una clasificación (ver capítulo 'Clasificaciones').
Las clasificaciones estan ordenadas por el campo 'orden' de cada clasificación.

Recurso 'landpage'

Los datos básicos agregados de las clasificaciones hijas de primer nivel y de segundo nivel de una familia se obtienen consumiendo el recurso siguiente:
[GET] /familia/:Clave/landpage.json
:Clave es la clave del recurso solicitado.

El sistema regresará los datos de la familia solicitada agregado de las clasificaciones hijas y nietas, así como de las recetas correspondientes a cada clasificación, pero con un límite de 4 en cantidad:
{ FAMILIA,
  "clasificaciones":
  [
    {CLASIFICACION-1
     "subclasificaciones": 
     [
       {SUBCLASIFICACION-1},
       {SUBCLASIFICACION-2},
       ...
     ],
     "recetas": 
     [
       {RECETARESUMEN-1},
       {RECETARESUMEN-2},
       ...
     ]
    },  
    ...
  ]
}
FAMILIA es el arreglo de la familia básica.
{CLASIFICACION-n} representa el objecto básico data de una clasificación (ver capítulo 'Clasificaciones').
Las clasificaciones estan ordenadas por el campo 'orden' de cada clasificación.
{SUBCLASIFICACION-n} representa el objecto básico data de una clasificación (ver capítulo 'Clasificaciones').
Las clasificaciones estan ordenadas por el campo 'orden' de cada clasificación.
{RECETARESUMEN-n} representa el objecto resumen de una receta (ver capítulo 'Recetas').
Las recetas estan ordenadas por el campo 'fecha' de cada receta en orden inverso (más recientes primero).

La cantidad de SUBCLASIFICACION y RECETARESUMEN suma 4 máximo.

Existen 2 recursos para las clasificaciones:
data: contiene los datos básicos de la clasificación
landpage: contiene los datos completos del landpage de la clasificación

Recurso 'data'


Para recuperar los datos de la clasificación con clave :N, puede consumir el recurso siguiente:
[GET] /clasificacion/:N/data.json
El sistema regresará los datos de la clasificacion:
[
  { "clave":"rec",
    "orden":"1",
    "nombre":"Recetas",
    "estatus":"1",
    "link":"recetas",
    "titulo":"Conoce nuestras deliciosas recetas",
    "palabras":"\u00bfEstas buscando recetas de cocina? Kiwilimon tiene las mejores recetas de cocina probadas con calificaciones, comentarios, tips y videos.",
    "ruta":"\/recetas",
    "cantidadclasificaciones":"14"
  },
  { "clave":"coc",
    "orden":"2",
    "nombre":"Tipo de cocina",
    "estatus":"1",
    "link":"tipo-de-cocina",
    "titulo":"",
    "palabras":"",
    "ruta":"\/tipo-de-cocina",
    "cantidadclasificaciones":"22"
  },
  ... 
]
El código regresado es un arreglo de familias.
Los campos de cada familia son:
clave: la clave interna de referencia de la familia en el GRAPH.
orden: número de orden. Normalmente el arreglo viene ordenado por este campo.
nombre: el nombre de la familia de clasificaciones.
estatus: el estatus de la familia. Siempre será 1 ya que solo las familias publicadas son visibles en el GRAPH.
link: es la liga básica para calcular la URL de la familia.
titulo: es el título HTML de la página referencia (land-page) de la familia.
palabras: es le meta tag "description" de la página referencia (land-page) de la familia.
ruta: es la ruta completa de la URL para acceder la página referencia (land-page) de la familia. Hay que agregar http://www.kiwilimon.com antes para acceder desde afuera del sitio.
cantidadclasificaciones: es la cantidad de clasificaciones publicadas en esta familia.