Búsquedas en el GRAPH
El contenedor permite realizar búsquedas de recetas sobre el graph, a través del metodo POST.
Parámetros fijos
Toda búsqueda tiene 3 parámetros fijos que hay que usar siempre:
-
primero: es la primera receta de la lista que necesitamos. 0 indica que no hay offset y apunta a la primera real. De 1 en adelante es un offset para saltar cantidad de recetas en la lista total.
-
cantidad: es la cantidad de recetas que queremos regresar a partir de la "primera" apuntada.
-
formato: es el formato en el cual queremos los resultados. Es uno de 'json', 'xml' o 'txt. Es un parámetro opcional, y si no esta especificado regresa un JSON por defecto.
Búsqueda con una palabra
La búsqueda sencilla se basa en un solo parámetro, 'q'.
[POST] /v2/buscar
q=pollo
primero=0
cantidad=20
formato=json
Búsqueda por ingredientes
La búsqueda por ingredientes necesita de 1 a 3 ingredientes en las variables 'ingrediente1', 'ingrediente2' e 'ingrediente3'.
'ingrediente2' e 'ingrediente3' son opcionales.
[POST] /v2/buscar
ingrediente1=pollo
ingrediente2=zanahoria
primero=0
cantidad=20
formato=json
Búsqueda por parametros
La búsqueda por parametros necesita de 3 parámetros especiales 'tipo', 'tiempo' y 'categoria'.
[POST] /v2/buscar
tipo=1
tiempo=30
categoria=1
primero=0
cantidad=20
formato=json
El
tipo representa una clasificación en la cual buscaremos las recetas. Por ejemplo, 1 = postres
El
tiempo es un valor posible en minutos de 1 a 120, representa el tiempo en minutos para realizar la receta y el sistema busca de tiempo-15 a tiempo minutos
La
categoria es un valor posible de 1 a 4:
1 = bajo en calorias,
2 = bajo en grasas,
3 = bajo en carbohidratos,
4 = sin azúcar
ESTE TIPO DE BÚSQUEDA SE VA A MODIFICAR PARA RESPONDER AL NUEVO BUSCADOR DE KIWI 4.0 Y ACEPTAR MAS PARAMETROS (CONSIDERANDO ENTRE OTROS CLASIFICACION, DIETAS A SEGUIR, CON/SIN VIDEOS, etc)
Resultados de la búsqueda
En todos los casos, el sistema regresará los datos de la búsqueda solicitada de la misma forma:
{ "cantidad": 2,
"cantidadtotal": 881,
"recetas":
[
{RECETA-1},
{RECETA-2},
...
]
}
Los campos son:
cantidad: la cantidad de recetas regresadas en este query (no mayor a la cantidad solicitada, pero puede ser menos).
cantidadtotal: cantidad total de recetas posibles que pueda regresar la búsqueda. En base a esta cantidad se puede paginar los resultados para no regresar demasiados datos en una consulta.
RECETA-n: representa el recurso "mresumen" de una receta (ver capítulo 'receta').
