Búsquedas de ingredientes 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 el primer resultado de la lista que necesitamos. 0 indica que no hay offset y apunta a la primero real. De 1 en adelante es un offset para saltar cantidad de resultados en la lista total.
-
cantidad: es la cantidad de resultados que queremos regresar a partir del "primero" apuntado.
-
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/buscaringrediente
q=harina
primero=0
cantidad=20
formato=json
Resultados de la búsqueda
En todos los casos, el sistema regresará los datos de la búsqueda solicitada de la misma forma:
{ "cantidad": 20,
"cantidadtotal": 32,
"ingredientes":
[
{INGREDIENTE-1},
{INGREDIENTE-2},
...
]
}
Los campos son:
cantidad: la cantidad de resultados regresados en este query (no mayor a la cantidad solicitada, pero puede ser menos).
cantidadtotal: cantidad total de resultados 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.
INGREDIENTE-n: representa el recurso "mdata" de un ingrediente (ver capítulo 'ingrediente').