ForHosting KIT · Outils pour développeurs

Adaptez une recette de cocktail au nombre de portions

Transformez une recette prévue pour un verre en un lot exploitable sans recommencer le calcul pour chaque alcool, jus, sirop ou garniture.

● BetaGratuit · dans votre navigateur

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Saisissez chaque ingrédient avec sa quantité individuelle et son unité, puis indiquez le nombre de boissons voulu. Le calculateur applique la même proportion à chaque ligne, conserve vos unités et renvoie les valeurs initiales et adaptées pour une fiche de préparation, une réception, un service de bar ou un traitement automatisé.

Partez d’une véritable recette individuelle

Utilisez les quantités nécessaires à une seule boisson terminée. Ajoutez une ligne pour chaque composant mesuré : alcools de base, modificateurs, agrumes, sirops, bitters, eau de dilution ou garnitures dénombrables. Indiquez un nom explicite, une quantité numérique non négative et une unité comme l’once liquide, le millilitre, le trait, la cuillère à café ou la pièce. Le calculateur ne convertit pas les unités, car leur conservation évite toute hypothèse sur la densité, les mesures régionales et la technique du bar. Veillez à la cohérence des lignes. Si votre source décrit déjà un pichet ou plusieurs verres, ramenez-la d’abord à une boisson. Cette base individuelle fait du nombre de portions demandé le facteur multiplicateur. Zéro convient à un composant volontairement répertorié, tandis que les valeurs négatives, absentes ou non numériques sont refusées.

Choisissez le nombre de portions et lisez le résultat

Définissez target_servings sur le nombre de cocktails à produire. Cette valeur doit être positive et peut être décimale pour un essai réduit. Puisque la recette envoyée correspond à une portion, chaque quantité est multipliée par ce nombre. Une formule contenant 2 onces d’alcool et 0.75 once de jus donne 16 et 6 onces pour huit portions. La réponse présente la cible, le facteur et une ligne par ingrédient. Chaque ligne conserve le nom et l’unité, avec original_amount à côté de scaled_amount pour simplifier le contrôle. Le calcul déterministe emploie une précision stable. Les unités restent des libellés, pas des consignes de conversion. Si une valeur est peu pratique pour votre matériel, arrondissez-la seulement après avoir choisi la tolérance adaptée à l’ingrédient.

Préparez un lot sans déséquilibrer le cocktail

La mise à l’échelle conserve les proportions mathématiques, mais la préparation demande toujours du discernement. Servez-vous du résultat comme plan d’ingrédients et traitez séparément les facteurs inhabituels : la glace ajoute de la dilution, l’acidité des agrumes varie, les éléments gazeux sont souvent ajoutés au dernier moment et les garnitures fragiles se préparent à part. Vérifiez le volume du récipient et gardez une marge pour mélanger et transporter. Pour les achats, comparez les totaux avec les conditionnements disponibles et arrondissez les achats vers le haut sans modifier les ratios. Lancez un calcul distinct pour chaque récipient si vous divisez le lot. L’API coûte $0.002 par requête et s’intègre aux outils événementiels, d’inventaire ou de préparation. Conservez l’entrée avec le résultat afin de garantir la traçabilité jusqu’à la recette individuelle.

Cas d’usage

Préparer des cocktails pour une réception

Convertissez une recette individuelle en quantités mesurées pour le nombre exact d’invités.

Créer une fiche de mise en place

Produisez des quantités cohérentes que l’équipe peut vérifier avant le service.

Estimer les achats d’un événement

Adaptez les ingrédients, puis comparez les totaux aux bouteilles, cartons et garnitures vendus.

Questions fréquentes

Quel est le tarif ?

Chaque requête API coûte $0.002.

La recette initiale doit-elle correspondre à une portion ?

Oui. Chaque quantité saisie doit décrire un cocktail ; le nombre de portions cible devient alors le multiplicateur.

Les onces sont-elles converties en millilitres ?

Non. L’unité saisie est conservée à l’identique et seule la quantité numérique est adaptée.

Le nombre de portions peut-il être décimal ?

Oui, à condition qu’il s’agisse d’un nombre fini et positif respectant la limite publiée.

Pourquoi une cible nulle ou négative est-elle refusée ?

Un lot doit représenter un nombre positif de portions ; zéro ou une valeur négative ne définit pas un lot utilisable.

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

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

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre 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)

Exemple de requête

{
  "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
}

Exemple de réponse

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

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Limites

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

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →