#coffee

Coffee-roasting maths as an API, computed locally and deterministically — the roast-profile numbers a home or specialty roaster tracks batch to batch. The loss endpoint works the weight-loss relationship from any two of the green weight, the roasted weight and the loss percentage: weight loss % = (green − roasted) / green × 100, so 1 kg of green dropping to 840 g is a 16 % loss, a 15 % target leaves 850 g, and to bag 800 g of roasted you charge 952 g of green (roasted ÷ (1 − loss%)). Light roasts shed about 12–14 %, medium 15–17 %, dark 18–20 %. The development endpoint computes the development time and the Development Time Ratio (DTR) from the total roast time and the first-crack time — DTR = (total − first crack) / total × 100, with most roasters aiming for roughly 20–25 %; times accepted as seconds or mm:ss. Everything is computed locally and deterministically, so it is instant and private. Ideal for coffee-roasting, roastery, specialty-coffee and roast-logging app developers, profile and batch tools, and roasting education. Pure local computation — no key, no third-party service, instant. Weights in grams, times in seconds or mm:ss. Live, nothing stored. 2 compute endpoints. This is roast-profile maths; for brewing ratios use a coffee-brewing API.

api.oanor.com/coffeeroast-api

Coffee brewing maths as an API, computed locally and deterministically. The ratio endpoint works out a brew recipe from any two of the coffee dose, the water and the brew ratio — water = coffee × ratio — and reports the third value, the ratio as 1:N, the number of cups and whether the recipe sits around the SCA "golden ratio" of about 1:16–1:17. The espresso endpoint does the same for espresso from any two of the dose, the yield and the brew ratio (yield = dose × brew ratio), labelling the shot ristretto, normale or lungo. The extraction endpoint computes the extraction yield, EY% = (beverage mass × TDS%) ÷ dose, from the dose, the brewed beverage mass (or the water, estimating the mass the grounds retain) and the measured total dissolved solids, then classifies the brew as under-extracted, ideal or over-extracted and weak through very strong against the SCA brewing control chart. Masses are in grams, water in grams or millilitres. Everything is computed locally and deterministically, so it is instant and private. Ideal for specialty-coffee, café, brewing-scale and recipe app developers, pour-over and espresso tools, and barista training. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 endpoints. This is coffee brewing maths; for cooking-unit conversions use a cooking API and for caffeine intake use a caffeine API.

api.oanor.com/coffee-api

Matemáticas del metabolismo de la cafeína como API, calculadas local y determinísticamente con un modelo de decaimiento de primer orden (exponencial). El endpoint de nivel calcula cuánta cafeína permanece en el cuerpo después de un tiempo dado desde una dosis y una vida media (aproximadamente 5 horas por defecto), en miligramos y porcentaje, y cuánto tiempo hasta que caiga a un umbral elegido. El endpoint de línea de tiempo devuelve una curva de decaimiento hora por hora y el tiempo hasta que la cafeína sea "segura para dormir" — por debajo de un umbral (50 mg por defecto) — útil para calcular un límite de café antes de acostarse. El endpoint de fuentes proporciona el contenido típico de cafeína de bebidas comunes (café filtrado, espresso, té, bebidas energéticas, cola y más) para una sola bebida, o totaliza una lista como dos cafés y una cola. Todo se calcula local y determinísticamente, por lo que es instantáneo y privado. Esto es solo informativo: la vida media real de la cafeína varía ampliamente entre personas (aproximadamente 3–7 horas, y mucho más larga durante el embarazo o con ciertos medicamentos) — no es consejo médico. Ideal para aplicaciones de café, sueño y bienestar, rastreadores de bebidas energéticas y hábitos, y herramientas de cuantificación personal. Cálculo local puro — sin clave, sin servicio de terceros, instantáneo. En vivo, nada almacenado. 3 endpoints. Esto es farmacocinética de la cafeína; para una base de datos de referencia de medicamentos, use una API de medicamentos.

api.oanor.com/caffeine-api