Saltar al contenido
🍟Crocantísimo
Crocantísimo

Documentación para desarrolladores y agentes de Crocantísimo

API pública, archivos machine-readable y negociación de contenido.

Recursos machine-readable

Negociación de contenido (Markdown)

Cualquier página de Crocantísimo responde en Markdown si pedís Accept: text/markdown. La respuesta incluye Vary: Accept para que los CDN no mezclen las variantes.

curl -H "Accept: text/markdown" https://crocantisimo.app/

Endpoints públicos

Buscar guías del blog

GET /api/blog/search — sin autenticación. Parámetros: q, cat, limit, offset.

curl "https://crocantisimo.app/api/blog/search?q=papas%20fritas&limit=5"

Buscar recetas por nombre

GET /api/recipes/search — sin autenticación. Parámetros: q (requerido), limit. Devuelve nombre, categoría, porciones, tiempo y la URL de cada receta (pedila con Accept: text/markdown para el paso a paso).

curl "https://crocantisimo.app/api/recipes/search?q=milanesa&limit=5"

Cocinar con lo que tengo

GET /api/recipes/pantry — sin autenticación. Parámetro tengo (ingredientes separados por coma). Devuelve recetas rankeadas por cobertura de tu despensa e indica qué falta.

curl "https://crocantisimo.app/api/recipes/pantry?tengo=pollo,papa,huevo"

Calculadora de asado

GET /api/asado — sin autenticación. Parámetros: adultos, ninos, apetito, entrada, achuras, provoleta. Devuelve cuánta carne, chorizos, carbón, etc.

curl "https://crocantisimo.app/api/asado?adultos=8&apetito=normal"

Comida para fiesta

GET /api/fiesta — sin autenticación. Parámetros: adultos, ninos, momento, empanadas, pizza, picada, torta. Devuelve empanadas, pizza, picada, bebida, etc.

curl "https://crocantisimo.app/api/fiesta?adultos=15&momento=cumple"

Cuánta guarnición por persona

GET /api/guarniciones — sin autenticación. Parámetro comensales. Devuelve cuánto arroz, fideos, papas, polenta, puré y legumbres cocinar.

curl "https://crocantisimo.app/api/guarniciones?comensales=6"

Temperaturas de la carne

GET /api/punto-carne — sin autenticación. Devuelve la temperatura interna de cada punto de la carne y las temperaturas de seguridad de pollo, cerdo y picada.

curl "https://crocantisimo.app/api/punto-carne"

Ajustar porciones de una receta

GET /api/porciones — sin autenticación. Parámetros de y a. Devuelve el factor por el que multiplicar los ingredientes.

curl "https://crocantisimo.app/api/porciones?de=4&a=6"

Adaptar una receta a otro molde

GET /api/molde — sin autenticación. Parámetros origen y destino con formato forma:medida (redondo:20, cuadrado:22, rectangular:20x30). Devuelve el factor por área.

curl "https://crocantisimo.app/api/molde?origen=redondo:20&destino=redondo:24"

Descargar un recetario gratis

POST /api/free-download — body JSON { email, slug }. Envía el recetario por email.

curl -X POST https://crocantisimo.app/api/free-download \
  -H "Content-Type: application/json" \
  -d '{"email":"tu@email.com","slug":"air-fryer"}'

Guía de tiempos y temperaturas

POST /api/lead — body JSON { email }. Envía la tabla imprimible por email.

Errores

Todos los errores de la API son JSON con código estable, mensaje y una pista de resolución (nunca HTML):

{
  "ok": false,
  "error": "email_invalido",
  "code": "email_invalido",
  "message": "El email no tiene un formato válido.",
  "hint": "Incluí un email válido en el campo \"email\"."
}

Contacto

Dudas de integración: hola@crocantisimo.app. Ver también Sobre Crocantísimo.

Volver al inicio