Introducción
El contenedor
recipe sirve principalmente para obtener los datos de una receta.
Disponible
Consideraciones:
El resultado obtenido depende del token de sesión del usuario conectado o no.
Un usuario no conectado tendrá poca información nutricional de la receta.
Tampoco todas las recetas son visibles por un usuario no conectado.
Un usuario conectado tendrá los 7 nutrientes básicos de una receta.
Un usuario PRO tendrá acceso a la tabla nutrimental completa (minerales, vitaminas, componentes, etc).
El conjunto de recetas PRO serán accesibles únicamente para un usuario PRO.
Solicitud básica
POST /v6/recipe
language=:Idioma
device=:Dispositivo
human=:Indicador
key=:Clave
path=:Ruta de receta
ingredients=:flag
explicado en el capítulo Generalidades
device explicado en el capítulo Generalidades
human explicado en el capítulo Generalidades
key es la clave de la receta solicitada
path ruta de la receta, si se envia "key", este tendrá prioridad sobre path. Parámetro OPCIONAL.
ingredients Opcional, si tiene un valor igual a "full" entonces regresará los ingredientes bajo la forma de los 3 sistemas de unidades oficiales y el original tal como capturado
Si ingredients no esta puesto, el sistema regresará los datos de la receta, de formato general:
{
"calories": 645,
"classification": 1,
"classificationpath": "/recetas/postres",
"client": 3,
"clientdata": {
"avatar": "https://scontent.xx.fbcdn.net/v/t1.0-1/p200x200/16807183_10158533166370227_832527199033195391_n.jpg?_nc_cat=100\u0026_nc_ohc=IXuogoYx1KEAQmqQwDXvU-UZHymygM_Y4VG1Fty5NdMvks3Af337UfuMQ\u0026_nc_ht=scontent.xx\u0026oh=713fbd1b162521c9f1325ef54522eee5\u0026oe=5E7D3474",
"firstname": "Lorenza",
"ckey": 3,
"lastname": "Avila",
"path": "/chef/7036255978"
},
"cooked": 1,
"cooktime": null,
"description": "Delicioso pastel bañado con leche. Se le puede poner cajeta arriba y queda delicioso.",
"device": "pc",
"difficulty": 2,
"favorites": 71,
"htmltitle": "Pastel de Tres Leches con Cajeta",
"image": "11398.jpg",
"images": [
{
"client": 173350,
"clientdata": {
"avatar": null,
"firstname": "Annabell",
"ckey": 173350,
"lastname": "Bori",
"path": "/chef/6501394061"
},
"image": "11398.jpg",
"ikey": 11398
}
],
"ingredients": [
{
"ikey": 3056,
"text": "2 tazas de harina, cernida"
},
{
"ikey": 3057,
"text": "1 taza de azúcar"
},
{
"ikey": 3058,
"text": "1 taza de queso crema, (al tiempo)"
},
{
"ikey": 3059,
"text": "3 cucharaditas de royal"
},
{
"ikey": 3060,
"text": "1 taza de leche"
},
{
"ikey": 3061,
"text": "225 gramos de mantequilla"
},
{
"ikey": 3062,
"text": "8 huevos"
},
{
"ikey": 3064,
"text": "1/2 tazas de leche condensada, para bañarlo"
},
{
"ikey": 3065,
"text": "1/2 tazas de leche carnation clavel, para bañarlo"
},
{
"ikey": 3066,
"text": "4 cucharaditas de brandy, para bañarlo"
}
],
"key": 154,
"keywords": "harina,azúcar,queso crema,royal,leche,mantequilla,huevo ,leche condensada,leche Carnation Clavel,brandy",
"language": "es",
"link": "pastel-de-tres-leches-con-cajeta",
"materials": [],
"metadescription": "Delicioso pastel bañado con leche. Se le puede poner cajeta arriba y queda delicioso.",
"name": "Pastel de Tres Leches con Cajeta",
"nutrients": [],
"path": "/receta/postres/pastel-de-tres-leches-con-cajeta",
"portions": 8,
"prating": "90.0%",
"presentation": "",
"published": "2009-11-29T01:29:50Z",
"rating": 4.5,
"recommended": null,
"review": 10,
"revised": 1,
"status": 1,
"steps": [
{
"skey": 75566,
"text": "Batir la mantequilla con el azúcar a que quede cremosa, agregar el queso crema y seguir batiendo, agregar los huevos uno en uno."
},
{
"skey": 75565,
"text": "Cernir la harina con el royal tres veces y agregarla a la mezcla alternándola con la leche, empezando y terminando con harina."
},
{
"skey": 75564,
"text": "Engrasar un molde de 28 cms de diámetro, poniendo un circulo de papel el cual también se engrasa, enharinarlo, vaciar la mezcla y hornear de 45 a 50 minutos a 180°C."
},
{
"skey": 75563,
"text": "Desmoldar y enfriar, mezclas las leches con el brandy y bañar pastel ya desmoldado."
},
{
"skey": 75562,
"text": "Poner encima un glaseado con 1 taza de azúcar glass cernida con 2 cucharadas de leche caliente y un poco de vainilla. A los lados poner un poco de leche condensada y nuez picada. Adornar con rebanaditas de durazno y nueces."
},
{
"skey": 76271,
"text": "También se puede decorar la parte de arriba con cajeta."
}
],
"time": 90,
"tips": "",
"titleh1": "Pastel de Tres Leches con Cajeta",
"video": null,
"videos": []
}
Cabe notar que los nombres de los campos vienen en inglés, siempre.
Los ingredientes vienen por defecto tal como se capturarón en la receta originalmente.
Las claves en los arrays internos vienen con la primera letra del objeto al cual corresponde:
- ckey para la clave de cliente
- ikey para la clave de una image o de un ingrediente
- nkey para la clave de un nutriente
- skey para la clave de un paso (step)
Esto con la finalidad de no mascar la clave de la receta (campo "key") para las plantillas jerarquicas.
Notas sobre nutrientes:
- Si la el sistema no pudo calcular el contenido nutricional, entonces el campo "nutrients" tendrá un array vacio.
- Si el usuario no esta conectado, entonces los nutrientes (campo "nutrients") regresará solamente 2 entradas: las calorias por 100 gramos y el tamaño de las porciones (key="999") en gramos.
- Si el usuario esta conectado, entonces los nutrientes tendrán 8 entradas:
Calorias, Carbohidratos, Proteinas, Lípidos, Fibra dietetica, Azúcares, Colesterol, y el tamaño de las porciones (key="999") en gramos.
- Finalmente, si el usuario es PRO, entonces regresará una amplia gama de nutrientes, incluyendo grasas, minerales y vitaminas, y el tamaño de las porciones (key="999") en gramos.
Ejemplos de los 3 tipos de nutrientes:
No conectado:
"nutrients": [
{
"nkey": "208",
"metric": "kcal",
"name": "Energía",
"order": 1,
"quantity100": "355.59932675099276"
},
{
"nkey": "999",
"metric": null,
"name": null,
"order": 999,
"quantity100": "100"
}
],
Conectado:
"nutrients": [
{
"nkey": "601",
"metric": "mg",
"name": "Colesterol",
"order": 7,
"quantity100": "43.22730995469767"
},
{
"nkey": "204",
"metric": "g",
"name": "Lípidos totales (grasas)",
"order": 4,
"quantity100": "17.155196023677597"
},
{
"nkey": "205",
"metric": "g",
"name": "Carbohidratos, por diferencia",
"order": 2,
"quantity100": "46.97992641383745"
},
{
"nkey": "208",
"metric": "kcal",
"name": "Energía",
"order": 1,
"quantity100": "355.59932675099276"
},
{
"nkey": "269",
"metric": "g",
"name": "Azúcares, total",
"order": 6,
"quantity100": "28.977300777095984"
},
{
"nkey": "291",
"metric": "g",
"name": "Fibra dietética total",
"order": 5,
"quantity100": "1.033976224478741"
},
{
"nkey": "203",
"metric": "g",
"name": "Proteína",
"order": 3,
"quantity100": "3.6471900982759062"
},
{
"nkey": "999",
"metric": null,
"name": null,
"order": 999,
"quantity100": "100"
}
],
Usuario PRO:
"nutrients": [
{
"nkey": "323",
"metric": "mg",
"name": "Vitamina E (alfa-tocoferol)",
"order": 33,
"quantity100": "2.115548198664714",
"quantityportion": "7.0335058",
"quantitytotal": "84.4020696"
},
{
"nkey": "601",
"metric": "mg",
"name": "Colesterol",
"order": 7,
"quantity100": "43.22730995469767",
"quantityportion": "143.71666666666667",
"quantitytotal": "1724.6000000000001"
},
{
"nkey": "204",
"metric": "g",
"name": "Lípidos totales (grasas)",
"order": 4,
"quantity100": "17.155196023677597",
"quantityportion": "57.0354156",
"quantitytotal": "684.4249872"
},
{
"nkey": "205",
"metric": "g",
"name": "Carbohidratos, por diferencia",
"order": 2,
"quantity100": "46.97992641383745",
"quantityportion": "156.192888975",
"quantitytotal": "1874.3146677"
},
{
"nkey": "431",
"metric": "µg",
"name": "Ácido fólico",
"order": 38,
"quantity100": "0",
"quantityportion": "0",
"quantitytotal": "0"
},
{
"nkey": "328",
"metric": "µg",
"name": "Vitamina D (D2 + D3)",
"order": 32,
"quantity100": "0.18046888071078698",
"quantityportion": "0.6",
"quantitytotal": "7.2"
},
{
"nkey": "301",
"metric": "mg",
"name": "Calcio, Ca",
"order": 21,
"quantity100": "20.555541365916604",
"quantityportion": "68.34045166665",
"quantitytotal": "820.0854199998"
},
{
"nkey": "415",
"metric": "mg",
"name": "Vitamina B-6",
"order": 35,
"quantity100": "0.07070682366627327",
"quantityportion": "0.23507706166666661",
"quantitytotal": "2.8209247399999993"
},
{
"nkey": "208",
"metric": "kcal",
"name": "Energía",
"order": 1,
"quantity100": "355.59932675099276",
"quantityportion": "1182.2514508333334",
"quantitytotal": "14187.01741"
},
{
"nkey": "307",
"metric": "mg",
"name": "Sodio, Na",
"order": 24,
"quantity100": "42.010009004665264",
"quantityportion": "139.66953916666336",
"quantitytotal": "1676.0344699999603"
},
{
"nkey": "269",
"metric": "g",
"name": "Azúcares, total",
"order": 6,
"quantity100": "28.977300777095984",
"quantityportion": "96.34004709166665",
"quantitytotal": "1156.0805650999998"
},
{
"nkey": "291",
"metric": "g",
"name": "Fibra dietética total",
"order": 5,
"quantity100": "1.033976224478741",
"quantityportion": "3.43763275",
"quantitytotal": "41.251593"
},
{
"nkey": "606",
"metric": "g",
"name": "Ácidos grasos, saturados totales",
"order": 12,
"quantity100": "4.05378813204259",
"quantityportion": "13.477519612499998",
"quantitytotal": "161.73023535"
},
{
"nkey": "646",
"metric": "g",
"name": "Ácidos grasos, poliinsaturados totales",
"order": 14,
"quantity100": "7.285866016648147",
"quantityportion": "24.22312142",
"quantitytotal": "290.67745704"
},
{
"nkey": "401",
"metric": "mg",
"name": "Vitamina C, ácido ascórbico total",
"order": 34,
"quantity100": "3.199941698527086",
"quantityportion": "10.6387595",
"quantitytotal": "127.66511400000002"
},
{
"nkey": "645",
"metric": "g",
"name": "Ácidos grasos, monoinsaturados totales",
"order": 13,
"quantity100": "4.7798074717900345",
"quantityportion": "15.891296448333334",
"quantitytotal": "190.69555738"
},
{
"nkey": "605",
"metric": "g",
"name": "Ácidos grasos, trans total",
"order": 11,
"quantity100": "0.0592915468501898",
"quantityportion": "0.197125",
"quantitytotal": "2.3655"
},
{
"nkey": "318",
"metric": "IU",
"name": "Vitamina A, UI",
"order": 31,
"quantity100": "3299.8975174892776",
"quantityportion": "10971.079904166669",
"quantitytotal": "131652.95885000002"
},
{
"nkey": "430",
"metric": "µg",
"name": "Vitamina K (filoquinona)",
"order": 37,
"quantity100": "3.0609761987880066",
"quantityportion": "10.176744666666666",
"quantitytotal": "122.12093599999999"
},
{
"nkey": "303",
"metric": "mg",
"name": "Hierro, Fe",
"order": 22,
"quantity100": "0.5053292723660187",
"quantityportion": "1.6800545458333334",
"quantitytotal": "20.16065455"
},
{
"nkey": "306",
"metric": "mg",
"name": "Potasio, K",
"order": 23,
"quantity100": "125.91897949867297",
"quantityportion": "418.63942083333336",
"quantitytotal": "5023.67305"
},
{
"nkey": "203",
"metric": "g",
"name": "Proteína",
"order": 3,
"quantity100": "3.6471900982759062",
"quantityportion": "12.125714141666665",
"quantitytotal": "145.50856969999998"
},
{
"nkey": "418",
"metric": "µg",
"name": "Vitamina B12",
"order": 36,
"quantity100": "0.09462083676155844",
"quantityportion": "0.3145833333333333",
"quantitytotal": "3.775"
},
{
"nkey": "999",
"metric": null,
"name": null,
"order": 999,
"quantity100": "100",
"quantityportion": "332.4672916665",
"quantitytotal": "3989.6074999979996"
}
],
Solicitud de ingredientes
Cuando se usa el campo ingredients=full en la solicitud, entonces el sistema regresará los ingredientes en los distintos sistemas de medición para desplegar en la receta:
- Sistema métrico (gramos, litros)
- Sistema americano (libras, onzas)
- Sistema de cocina (tazas, cucharadas)
- Sistema original (tal como capturado, puede tener de los 3 sistemas anteriores mezclados)
{
"american": [
{
"ikey": 18220,
"text": "13.23 onzas de harina"
},
{
"ikey": 18221,
"text": "2/3 libras de azúcar"
},
{
"ikey": 18222,
"text": "0.42 onzas de bicarbonato"
},
{
"ikey": 18223,
"text": "0.28 onzas de canela"
},
{
"ikey": 18224,
"text": "0.21 onzas de sal"
},
{
"ikey": 305646,
"text": "16.89 onzas líquidas de aceite de maíz"
},
{
"ikey": 18226,
"text": "6 huevos"
},
{
"ikey": 18227,
"text": "14.29 onzas de zanahoria, rallada cruda"
},
{
"ikey": 18228,
"text": "6.61 onzas de nuez, picada y tostada al horno"
},
{
"ikey": 18230,
"text": "1/2 libras de mantequilla, (para el betún)"
},
{
"ikey": 18229,
"text": "13.4 onzas de queso crema, para el betún"
},
{
"ikey": 18231,
"text": "1.49 libras de azúcar glass, (para el betún)"
},
{
"ikey": 18232,
"text": "67.57 onzas líquidas de vainilla líquida, (para el betún)"
},
{
"ikey": 358206,
"text": "0.51 onzas líquidas de vainilla líquida"
},
{
"ikey": 358207,
"text": "2 gotas de colorante vegetal, para el betún"
},
{
"ikey": 358208,
"text": "5 nueces, para decorar"
}
],
"cooking": [
{
"ikey": 18220,
"text": "3 tazas de harina"
},
{
"ikey": 18221,
"text": "1 1/2 tazas de azúcar"
},
{
"ikey": 18222,
"text": "3 cucharaditas de bicarbonato"
},
{
"ikey": 18223,
"text": "3 cucharaditas de canela"
},
{
"ikey": 18224,
"text": "1 1/2 cucharaditas de sal"
},
{
"ikey": 305646,
"text": "2 tazas de aceite de maíz"
},
{
"ikey": 18226,
"text": "6 huevos"
},
{
"ikey": 18227,
"text": "3 tazas de zanahoria, rallada cruda"
},
{
"ikey": 18228,
"text": "3/4 tazas de nuez, picada y tostada al horno"
},
{
"ikey": 18230,
"text": "1 taza de mantequilla, (para el betún)"
},
{
"ikey": 18229,
"text": "1.69 tazas de queso crema, para el betún"
},
{
"ikey": 18231,
"text": "3 tazas de azúcar glass, (para el betún)"
},
{
"ikey": 18232,
"text": "8 tazas de vainilla líquida, (para el betún)"
},
{
"ikey": 358206,
"text": "1 cucharada de vainilla líquida"
},
{
"ikey": 358207,
"text": "2 gotas de colorante vegetal, para el betún"
},
{
"ikey": 358208,
"text": "5 nueces, para decorar"
}
],
"device": "pc",
"international": [
{
"ikey": 18220,
"text": "375 gramos de harina"
},
{
"ikey": 18221,
"text": "300 gramos de azúcar"
},
{
"ikey": 18222,
"text": "12 gramos de bicarbonato"
},
{
"ikey": 18223,
"text": "7.95 gramos de canela"
},
{
"ikey": 18224,
"text": "6 gramos de sal"
},
{
"ikey": 305646,
"text": "1/2 litros de aceite de maíz"
},
{
"ikey": 18226,
"text": "6 huevos"
},
{
"ikey": 18227,
"text": "405 gramos de zanahoria, rallada cruda"
},
{
"ikey": 18228,
"text": "187.5 gramos de nuez, picada y tostada al horno"
},
{
"ikey": 18230,
"text": "225 gramos de mantequilla, (para el betún)"
},
{
"ikey": 18229,
"text": "380 gramos de queso crema, para el betún"
},
{
"ikey": 18231,
"text": "675 gramos de azúcar glass, (para el betún)"
},
{
"ikey": 18232,
"text": "2 mililitros de vainilla líquida, (para el betún)"
},
{
"ikey": 358206,
"text": "0.02 litros de vainilla líquida"
},
{
"ikey": 358207,
"text": "2 gotas de colorante vegetal, para el betún"
},
{
"ikey": 358208,
"text": "5 nueces, para decorar"
}
],
"language": "es",
"original": [
{
"ikey": 18220,
"text": "3 tazas de harina"
},
{
"ikey": 18221,
"text": "1 1/2 tazas de azúcar"
},
{
"ikey": 18222,
"text": "3 cucharaditas de bicarbonato"
},
{
"ikey": 18223,
"text": "3 cucharaditas de canela"
},
{
"ikey": 18224,
"text": "1 1/2 cucharaditas de sal"
},
{
"ikey": 305646,
"text": "2 tazas de aceite de maíz"
},
{
"ikey": 18226,
"text": "6 huevos"
},
{
"ikey": 18227,
"text": "3 tazas de zanahoria, rallada cruda"
},
{
"ikey": 18228,
"text": "3/4 tazas de nuez, picada y tostada al horno"
},
{
"ikey": 18230,
"text": "1 taza de mantequilla, (para el betún)"
},
{
"ikey": 18229,
"text": "380 gramos de queso crema, para el betún"
},
{
"ikey": 18231,
"text": "3 tazas de azúcar glass, (para el betún)"
},
{
"ikey": 18232,
"text": "2 mililitros de vainilla líquida, (para el betún)"
},
{
"ikey": 358206,
"text": "1 cucharada de vainilla líquida"
},
{
"ikey": 358207,
"text": "2 gotas de colorante vegetal, para el betún"
},
{
"ikey": 358208,
"text": "5 nueces, para decorar"
}
]
}
Los 4 sistemas vienen juntos, el usuario puede intercambiar entre los varios sistemas.
Códigos de error
Si la clave solicitada no existe en el sistema, regresará un estatus 404
Si el sistema esta en mantenimiento, puede regresar un estatus 503
Si accede otros métodos, puede regresar un estatus 501
Si hay un problema en el sistema, puede regresar un estatus 500
