ForHosting KIT · Strumenti per sviluppatori

Adatti una ricetta cocktail a qualsiasi numero di porzioni

Trasformi una ricetta per un solo bicchiere in un lotto pratico senza ripetere i calcoli per ogni distillato, succo, sciroppo o guarnizione.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Inserisca ciascun ingrediente con la quantità per una porzione e la relativa unità, quindi scelga quante bevande preparare. Il calcolatore applica la stessa proporzione a ogni riga, conserva le unità indicate e restituisce quantità originali e adattate per una scheda di preparazione, un evento, il servizio bar o un flusso automatizzato.

Parta da una vera ricetta monoporzione

Utilizzi le quantità necessarie per ottenere esattamente una bevanda finita. Aggiunga una riga per ogni componente misurato, compresi distillati di base, modificatori, agrumi, sciroppi, bitter, acqua per la diluizione o guarnizioni conteggiabili. Indichi un nome chiaro, una quantità numerica non negativa e un’unità come once fluide, millilitri, dash, cucchiaini o pezzi. Il calcolatore non converte le unità: conservarle evita ipotesi nascoste su densità, misure regionali e tecniche di miscelazione. Mantenga coerenti tutte le righe. Se la fonte descrive già una caraffa o più bicchieri, la divida prima fino a ottenere una singola bevanda. Questa base rende il numero di porzioni richiesto uguale al fattore di scala. Lo zero è ammesso per un componente elencato intenzionalmente; quantità negative, mancanti o non numeriche vengono invece rifiutate.

Scelga le porzioni e interpreti il risultato

Imposti target_servings sul numero di cocktail che intende produrre. Il valore deve essere positivo e può essere decimale per una prova ridotta. Poiché la ricetta inviata rappresenta una porzione, lo strumento moltiplica ogni quantità per tale numero. Una formula con 2 once di distillato e 0.75 once di succo diventa 16 e 6 once per otto porzioni. La risposta riporta l’obiettivo, il fattore e una riga per ingrediente. Ogni riga conserva nome e unità e mostra original_amount accanto a scaled_amount, agevolando il controllo. Il calcolo è deterministico e usa una precisione stabile. Le unità sono etichette, non istruzioni di conversione. Se una quantità risulta scomoda per l’attrezzatura, la arrotondi solo dopo aver stabilito la tolleranza adatta a quell’ingrediente.

Pianifichi il lotto senza perdere l’equilibrio

La proporzione matematica della ricetta resta invariata, ma la preparazione richiede comunque attenzione pratica. Usi il risultato come piano degli ingredienti e gestisca separatamente ciò che non costituisce una quantità ordinaria. Il ghiaccio aggiunge diluizione, l’acidità degli agrumi varia, gli ingredienti gassati spesso vanno aggiunti al momento del servizio e le guarnizioni delicate si preparano a parte. Controlli il volume del contenitore e lasci spazio per trasporto e miscelazione. Per gli acquisti, confronti i totali con le confezioni reali e arrotondi la spesa verso l’alto senza cambiare i rapporti. Esegua calcoli separati se divide il lotto. L’API costa $0.002 per richiesta e può integrarsi in sistemi per eventi, inventario o preparazione. Conservi l’input insieme al risultato per risalire sempre alla ricetta individuale.

Casi d'uso

Preparare cocktail per una festa

Converta una ricetta monoporzione nelle quantità misurate per il numero esatto di ospiti.

Creare una scheda di preparazione

Generi dosi coerenti che il personale possa verificare prima del servizio.

Stimare gli acquisti per un evento

Adatti gli ingredienti e confronti i totali con bottiglie, cartoni e confezioni disponibili.

Domande frequenti

Qual è il costo?

Ogni richiesta API costa $0.002.

La ricetta originale deve produrre una porzione?

Sì. Ogni quantità inserita deve descrivere un cocktail; il numero di porzioni desiderato diventa il moltiplicatore.

Lo strumento converte le once in millilitri?

No. Mantiene esattamente l’unità fornita e adatta soltanto il valore numerico.

Il numero di porzioni può essere decimale?

Sì, purché sia un numero finito e positivo entro il limite pubblicato.

Perché un obiettivo zero o negativo viene rifiutato?

Un lotto deve rappresentare un numero positivo di porzioni; zero e valori negativi non descrivono un lotto utilizzabile.

Per sviluppatori — accesso via API

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

Endpoint

POSThttps://api.kit.forhosting.com/cook/cocktail-recipe-scale

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

Chiamala dal tuo stack

curl -X POST https://api.kit.forhosting.com/cook/cocktail-recipe-scale \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ingredients":[{"name":"Gin","amount":2,"unit":"fl oz"},{"name":"Lemon juice","amount":0.75,"unit":"fl oz"},{"name":"Simple syrup","amount":0.5,"unit":"fl oz"}],"target_servings":8}'

const res = await fetch("https://api.kit.forhosting.com/cook/cocktail-recipe-scale", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "ingredients": [
      {
        "name": "Gin",
        "amount": 2,
        "unit": "fl oz"
      },
      {
        "name": "Lemon juice",
        "amount": 0.75,
        "unit": "fl oz"
      },
      {
        "name": "Simple syrup",
        "amount": 0.5,
        "unit": "fl oz"
      }
    ],
    "target_servings": 8
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/cook/cocktail-recipe-scale",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "ingredients": [
        {
            "name": "Gin",
            "amount": 2,
            "unit": "fl oz"
        },
        {
            "name": "Lemon juice",
            "amount": 0.75,
            "unit": "fl oz"
        },
        {
            "name": "Simple syrup",
            "amount": 0.5,
            "unit": "fl oz"
        }
    ],
    "target_servings": 8
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/cook/cocktail-recipe-scale", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"ingredients":[{"name":"Gin","amount":2,"unit":"fl oz"},{"name":"Lemon juice","amount":0.75,"unit":"fl oz"},{"name":"Simple syrup","amount":0.5,"unit":"fl oz"}],"target_servings":8}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"ingredients":[{"name":"Gin","amount":2,"unit":"fl oz"},{"name":"Lemon juice","amount":0.75,"unit":"fl oz"},{"name":"Simple syrup","amount":0.5,"unit":"fl oz"}],"target_servings":8}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/cook/cocktail-recipe-scale", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Esempio di richiesta

{
  "ingredients": [
    {
      "name": "Gin",
      "amount": 2,
      "unit": "fl oz"
    },
    {
      "name": "Lemon juice",
      "amount": 0.75,
      "unit": "fl oz"
    },
    {
      "name": "Simple syrup",
      "amount": 0.5,
      "unit": "fl oz"
    }
  ],
  "target_servings": 8
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "cook.cocktail_recipe_scale",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

Prezzi

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

Limiti

`max_ingredients`	200
`max_amount`	1000000000
`max_servings`	1000000

Errori

HTTP	Codice	Significato
`401`	`unauthorized`	Chiave API mancante o non valida: controlla l'header Authorization.
`402`	`insufficient_balance`	Credito esaurito: ricarica per continuare a eseguire attività.
`404`	`unknown_type`	Tipo di attività sconosciuto: controlla il campo type della richiesta.
`429`	`rate_limited`	Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →