ウェブサイト上で紹介しているカクテル情報を取得可能なAPIを提供しています。
現在のバージョンは「V1」です。下方互換を持たないAPIのアップデートを行う場合はバージョンを更新します。
バージョンが更新された場合も過去のバージョンは使用可能な状態とします。
本APIはRESTで構成されており、HTTPSで下記URLよりアクセス可能です。レスポンス項目はすべてUTF-8のJSON形式で受け取ることができます。
https://cocktail-f.com/api/v1/
問題の報告、質問等ありましたら下記までご連絡ください。
メール:satodai42@gmail.com
カクテルの検索および一覧を取得します。パラメータを指定することで条件の絞り込みが可能です。
リクエスト先URL
https://cocktail-f.com/api/v1/cocktails
指定可能パラメータ一覧
パラメータ名 | パラメータ | フォーマット | 備考 |
---|---|---|---|
検索文字列 | word | 全半角文字列 最大20文字 | |
ベース | base | 半角数字 | 1:ジン, 2:ウォッカ, 3:テキーラ, 4:ラム, 5:ウイスキー, 6:ブランデー, 7:リキュール, 8:ワイン, 9:ビール, 10:日本酒, 0:ノンアルコール |
技法 | technique | 半角数字 | 1:ビルド, 2:ステア, 3:シェイク |
味わい | taste | 半角数字 | 1:甘口, 2:中甘口, 3:中口, 4:中辛口, 5:辛口 |
スタイル | style | 半角数字 | 1:ショート, 2:ロング |
アルコール度数from | alcohol_from | 半角数字 範囲:0-100 | アルコール度数from <= アルコール度数to とすること |
アルコール度数to | alcohol_to | 半角数字 範囲:0-100 | アルコール度数from <= アルコール度数to とすること |
TPO | tpo | 半角数字 | 1:食前, 2:食後, 3:オール |
グラス | glass | 半角数字 | 1:カクテルグラス, 2:オールドファッションドグラス, 3:コリンズグラス, 4:タンブラー, 5:ワイングラス, 6:シャンパングラス, 7:ホットグラス, 8:ゴブレット, 9:リキュールグラス, 10:サワーグラス, 11:ピルスナーグラス |
色 | color | 半角数字 | 1:透明, 2:赤, 3:青, 4:黄, 5:茶色, 6:緑, 7:オレンジ, 8:白, 9:黄金色, 10:黒, 11:ピンク, 12:複数色 |
タグ | tag | 半角数字 | 1:スタンダード, 2:オリジナル, 3:シンプル, 4:さっぱり, 5:爽やか, 6:まろやか, 7:キレがある, 8:酸っぱい, 9:濃厚, 10:強い, 11:飲みやすい, 12:酔い醒まし, 13:楽しい, 14:美しい, 15:ホット, 16:トロピカル, 17:エレガント, 18:男らしい, 19:女性におすすめ, 20:歴史ある, 21:プース・カフェ, 22:料理に合う, 23:VA-11 Hall-A, 24:CyberPunk 2077 |
表示ページ | page | 半角数字 範囲:1-1000 | ページネーションが可能。未指定時はデフォルトで1を設定。 |
1ページ表示件数 | limit | 半角数字 範囲:1-100 | ページネーションが可能。未指定時はデフォルトで20を設定。 |
レスポンス項目一覧
パラメータ名 | パラメータ | 親要素 | 備考 |
---|---|---|---|
ステータス | status | なし | 正常時:0000 異常時は下記のエラー一覧を参照 |
エラー詳細 | error_detail | なし | 異常時のみ |
総ページ数 | total_pages | なし | 正常時のみ |
現在のページ番号 | current_page | なし | 正常時のみ |
カクテル情報リスト | cocktails | なし | 正常時のみ |
カクテルID | cocktail_id | cocktails | 後述のカクテル情報照会APIのid値として使用する値 |
カクテル名 | cocktail_name | cocktails | |
カクテル英語名 | cocktail_name_english | cocktails | |
ベース | base_name | cocktails | |
技法 | technique_name | cocktails | |
味わい | taste_name | cocktails | |
スタイル | style_name | cocktails | |
アルコール度数 | alcohol | cocktails | |
TPO | tpo_name | cocktails | |
グラス | glass_name | cocktails | |
タイプ | type_name | cocktails | |
色 | color_name | cocktails | |
カクテル要約 | cocktail_digest | cocktails | |
カクテル説明 | cocktail_desc | cocktails | |
レシピ情報リスト | recipes | cocktails | |
材料ID | ingredient_id | recipes | |
材料名 | ingredient_name | recipes | |
分量 | amount | recipes | 単位が「適量」「FullUP」の場合はnullを返却 |
単位 | unit | recipes | 単位として返却しうる値:ml,tsp.,dash,枚,個,適量,FullUP,glass |
タグ情報リスト | tags | cocktails | |
タグID | tag_id | tags | |
タグ名 | tag_name | tags |
パラメータ未指定時のリクエスト・レスポンス例
https://cocktail-f.com/api/v1/cocktails
{ "status": "0000", "total_pages": 5, "current_page": 1, "cocktails": [ { "cocktail_id": 1, "cocktail_name": "マティーニ", "cocktail_name_english": "Martini", "base_name": "ジン", "technique_name": "ステア", "taste_name": "辛口", "style_name": "ショート", "alcohol": 42, "top_name": "食前", "glass_name": "カクテルグラス", "type_name": "アルコール", "cocktail_digest": "カクテルの王様", "cocktail_desc": "ジンの辛味とドライベルモットの香りが絶妙なカクテルの王様。時代が進むにつれ辛口へと変化している。使用するお酒の種類や配合が無数にあるため、バーによって味が異なると言われている。カクテル好きなら1度は味わっておきたい一杯。", "recipe_desc": "ジンとドライベルモットをミキシンググラスでステアし、グラスに注ぐ。オリーブをカクテルピックに刺して沈め、仕上げにレモンピールをふる。", "recipes": [ { "ingredient_id": 1, "ingredient_name": "ジン", "amount": "50", "unit": "ml" }, { "ingredient_id": 15, "ingredient_name": "ドライ・ベルモット", "amount": "10", "unit": "ml" }, { "ingredient_id": 47, "ingredient_name": "オリーブ", "amount": "1", "unit": "個" }, { "ingredient_id": 48, "ingredient_name": "レモン・ピール", "amount": "", "unit": "適量" } ] }, { "cocktail_id": 2, "cocktail_name": "テキーラ・サンライズ", "cocktail_name_english": "Tequila Sunrise", "base_name": "テキーラ", "technique_name": "ビルド", "taste_name": "中甘口", "style_name": "ロング", "alcohol": 13, "top_name": "オール", "glass_name": "ゴブレット", "type_name": "アルコール", "cocktail_digest": "日の出をイメージした美しいカクテル", "cocktail_desc": "グレナデン・シロップとオレンジジュースのグラデーションで日の出を表現した美しいカクテル。テキーラ独特の風味とオレンジジュースがマッチした一品。", "recipe_desc": "グラスに氷、テキーラ、オレンジジュースを入れてステア(混ぜる)する。グレナデン・シロップを氷に当たらないよう静かに注いで沈めた後、きれいなグラデーションとなるようにバー・スプーンで持ち上げるように混ぜる。", "recipes": [ { "ingredient_id": 3, "ingredient_name": "テキーラ", "amount": "45", "unit": "ml" }, { "ingredient_id": 34, "ingredient_name": "オレンジ・ジュース", "amount": "", "unit": "FullUP" }, { "ingredient_id": 49, "ingredient_name": "グレナデン・シロップ", "amount": "2", "unit": "tsp." } ] }, { "cocktail_id": 3, "cocktail_name": "ジン・トニック", "cocktail_name_english": "Gin Tonic", "base_name": "ジン", "technique_name": "ビルド", "taste_name": "中辛口", "style_name": "ロング", "alcohol": 16, "top_name": "オール", "glass_name": "タンブラー", "type_name": "アルコール", "cocktail_digest": "ジンの良さをを気軽に楽しめる王道のカクテル", "cocktail_desc": "ジンとトニックウォーターをビルドするシンプルなレシピ。家でも簡単に作れる上、さっぱりして飲みやすい。シンプルかつスタンダードなカクテルが故にバーテンダーの腕が出やすいとされる。なお、トニックウォーターだけでは甘すぎる場合は炭酸水を半分入れたジン・ソニックというカクテルもある。", "recipe_desc": "グラスに氷を入れてジン注ぎ、その後冷えたトニック・ウォーターでグラスを満たし、炭酸が抜けないよう軽くステアする。最後にカットしたライムを飾り付ける。", "recipes": [ { "ingredient_id": 1, "ingredient_name": "ジン", "amount": "45", "unit": "ml" }, { "ingredient_id": 35, "ingredient_name": "トニック・ウォーター", "amount": "", "unit": "FullUP" }, { "ingredient_id": 50, "ingredient_name": "ライム", "amount": "1/6", "unit": "個" } ] }, { "cocktail_id": 4, "cocktail_name": "XYZ", "cocktail_name_english": "XYZ", "base_name": "ラム", "technique_name": "シェイク", "taste_name": "中辛口", "style_name": "ショート", "alcohol": 30, "top_name": "オール", "glass_name": "カクテルグラス", "type_name": "アルコール", "cocktail_digest": "「これで終わり」の意味が込められたカクテル", "cocktail_desc": "ラムベースの中でもスタンダードカクテルで、ラムの甘みと柑橘の酸味がバランスよく飲みやすい。アルファベット最後の3文字から、「これで終わり」や「これ以上のものはない」といった意味がある。漫画シティーハンターでも登場し、こちらでは「後がない」という意味で登場する。", "recipe_desc": "シェーカーにすべての材料と氷を入れてシェイクし、グラスに注ぐ。", "recipes": [ { "ingredient_id": 11, "ingredient_name": "ホワイト・ラム", "amount": "40", "unit": "ml" }, { "ingredient_id": 14, "ingredient_name": "ホワイト・キュラソー", "amount": "10", "unit": "ml" }, { "ingredient_id": 37, "ingredient_name": "レモン・ジュース", "amount": "10", "unit": "ml" } ] }, { "cocktail_id": 5, "cocktail_name": "モヒート", "cocktail_name_english": "Mojito", "base_name": "ラム", "technique_name": "ビルド", "taste_name": "中口", "style_name": "ロング", "alcohol": 23, "top_name": "オール", "glass_name": "コリンズグラス", "type_name": "アルコール", "cocktail_digest": "近年人気のオシャレでさっぱりとしたカクテル", "cocktail_desc": "ラムの甘み、ミントのさわやかな香り、ライムの酸味、炭酸水の爽快感がある夏にぴったりのカクテル。ウイスキーのハイボールよりもスッキリとして飲みやすく、見た目のオシャレさも合わさって日本で人気が高まっている。", "recipe_desc": "グラスにスペア・ミント、シュガー・シロップを入れて潰す。その後、ライムを絞ってそのままグラスの中へ入れる。氷を入れ、ホワイト・ラムを注ぎ一度ステア(混ぜる)する。最後に炭酸水を注ぎ、炭酸が抜けないよう軽くステアする。", "recipes": [ { "ingredient_id": 11, "ingredient_name": "ホワイト・ラム", "amount": "45", "unit": "ml" }, { "ingredient_id": 50, "ingredient_name": "ライム", "amount": "1/2", "unit": "個" }, { "ingredient_id": 52, "ingredient_name": "シュガー・シロップ", "amount": "10", "unit": "ml" }, { "ingredient_id": 54, "ingredient_name": "スペア・ミント", "amount": "10-15", "unit": "枚" }, { "ingredient_id": 33, "ingredient_name": "炭酸水", "amount": "", "unit": "FullUP" } ] }, { "cocktail_id": 6, "cocktail_name": "ホワイト・レディ", "cocktail_name_english": "White Lady", "base_name": "ジン", "technique_name": "シェイク", "taste_name": "中辛口", "style_name": "ショート", "alcohol": 34, "top_name": "オール", "glass_name": "カクテルグラス", "type_name": "アルコール", "cocktail_digest": "白いドレスの貴婦人をイメージした艶のあるカクテル", "cocktail_desc": "1919年、ロンドンの「シローズ・クラブ」のハリーマッケンホルン氏が考案したカクテル。ジンの切れのある味わいに甘みと酸味がマッチしたバランスの良いスタンダードなカクテル。ベースのお酒を変えることでサイドカー、バラライカ、XYZ等のカクテルとなる。", "recipe_desc": "シェーカーにすべての材料と氷を入れてシェイクし、グラスに注ぐ。", "recipes": [ { "ingredient_id": 1, "ingredient_name": "ジン", "amount": "30", "unit": "ml" }, { "ingredient_id": 14, "ingredient_name": "ホワイト・キュラソー", "amount": "15", "unit": "ml" }, { "ingredient_id": 37, "ingredient_name": "レモン・ジュース", "amount": "15", "unit": "ml" } ] }, { "cocktail_id": 7, "cocktail_name": "ブラッディ・メアリー", "cocktail_name_english": "Bloody Mary", "base_name": "ウォッカ", "technique_name": "ビルド", "taste_name": "中口", "style_name": "ロング", "alcohol": 11, "top_name": "オール", "glass_name": "コリンズグラス", "type_name": "アルコール", "cocktail_digest": "二日酔いで辛い朝に迎え酒としても飲まれる一杯", "cocktail_desc": "血まみれメアリーと呼ばれたイングランド女王のメアリー1世が由来とされる。野菜スティックを添えたり、ウスターソース、胡椒、タバスコをかける場合もあり、海外では迎え酒として二日酔いの際にも飲まれる。つまんねー事聞くなよ?", "recipe_desc": "グラスに氷とすべての材料を入れてステア(混ぜる)する。好みで野菜スティックやレモンを添える。", "recipes": [ { "ingredient_id": 2, "ingredient_name": "ウォッカ", "amount": "45", "unit": "ml" }, { "ingredient_id": 39, "ingredient_name": "トマト・ジュース", "amount": "", "unit": "適量" } ] }, { "cocktail_id": 8, "cocktail_name": "ウォッカ・マティーニ", "cocktail_name_english": "Vodka Martini", "base_name": "ウォッカ", "technique_name": "ステア", "taste_name": "辛口", "style_name": "ショート", "alcohol": 36, "top_name": "食前", "glass_name": "カクテルグラス", "type_name": "アルコール", "cocktail_digest": "ベースをウォッカに変えスムースでソフトな飲み口のマティーニ", "cocktail_desc": "使用する材料をドライ・ジンをウォッカに変えたマティーニ。ウォッカを使うことでジン特有のクセがなくなり、ややソフトな味わいになる。", "recipe_desc": "ウォッカとドライベルモットをミキシンググラスでステアし、グラスに注ぐ。オリーブをカクテルピックに刺して沈め、仕上げにレモンピールをふる。", "recipes": [ { "ingredient_id": 2, "ingredient_name": "ウォッカ", "amount": "45", "unit": "ml" }, { "ingredient_id": 15, "ingredient_name": "ドライ・ベルモット", "amount": "15", "unit": "ml" } ] }, { "cocktail_id": 9, "cocktail_name": "キューバ・リブレ", "cocktail_name_english": "Cuba Libre", "base_name": "ラム", "technique_name": "ビルド", "taste_name": "中口", "style_name": "ロング", "alcohol": 13, "top_name": "オール", "glass_name": "タンブラー", "type_name": "アルコール", "cocktail_digest": "キューバの自由万歳!Viva Cuba Libre!", "cocktail_desc": "第二次キューバ独立戦争の合言葉から名前のついたカクテルで一般的にラムコークとも呼ばれる。ライムがあれば家でも簡単に作ることができる。ラムのコクとコーラのさっぱりとした味わいにライムの酸味が加わって暑いときにグッと飲みたい味わい。", "recipe_desc": "グラスにライムを絞り入れてラムを注ぎ、氷を入れてステア(混ぜる)する。その後冷えたコーラでグラスを満たし、軽くステアする。", "recipes": [ { "ingredient_id": 11, "ingredient_name": "ホワイト・ラム", "amount": "45", "unit": "ml" }, { "ingredient_id": 40, "ingredient_name": "コーラ", "amount": "", "unit": "FullUP" }, { "ingredient_id": 50, "ingredient_name": "ライム", "amount": "1/2", "unit": "個" } ] }, { "cocktail_id": 10, "cocktail_name": "青い珊瑚礁", "cocktail_name_english": "Blue Coral Reef", "base_name": "ジン", "technique_name": "シェイク", "taste_name": "中甘口", "style_name": "ショート", "alcohol": 38, "top_name": "オール", "glass_name": "カクテルグラス", "type_name": "アルコール", "cocktail_digest": "日本生まれの色合い美しくミントの爽快な味わいを楽しむ", "cocktail_desc": "淡いグリーンとマラスキーノ・チェリーの赤色の対比が美しい日本生まれのカクテル。ミントリキュールの爽快な味わいが特徴。1950年の第2回オールジャパン・ドリンクス・コンクールの優勝作品。", "recipe_desc": "グラスの縁をレモンで濡らす。シェーカーにジンとグリーン・ミント・リキュールと氷を入れてシェイクし、グラスに注ぐ。最後にマラスキーノ・チェリーをグラスに鎮める。", "recipes": [ { "ingredient_id": 1, "ingredient_name": "ジン", "amount": "40", "unit": "ml" }, { "ingredient_id": 18, "ingredient_name": "グリーン・ミント・リキュール", "amount": "20", "unit": "ml" }, { "ingredient_id": 55, "ingredient_name": "マラスキーノ・チェリー", "amount": "1", "unit": "個" }, { "ingredient_id": 37, "ingredient_name": "レモン・ジュース", "amount": "", "unit": "適量" } ] }, { "cocktail_id": 11, "cocktail_name": "ギムレット", "cocktail_name_english": "Gimlet", "base_name": "ジン", "technique_name": "シェイク", "taste_name": "辛口", "style_name": "ショート", "alcohol": 32, "top_name": "食前", "glass_name": "カクテルグラス", "type_name": "アルコール", "cocktail_digest": "ハードボイルドに決めたい、そんな時にオススメの一杯", "cocktail_desc": "ジンとライムのキレのある味わいのスタンダードなカクテル。シンプルだがバーによって味わいが異なるのが面白い。小説「長いお別れ」の中で登場する「ギムレットには早すぎる」というセリフが有名で、小説の中ではジンとイギリス・ローズ社製のライムジュースを半分ずつとなっているが、実際は様々なレシピが存在する。", "recipe_desc": "シェーカーにすべての材料と氷を入れてシェイクし、グラスに注ぐ。", "recipes": [ { "ingredient_id": 1, "ingredient_name": "ジン", "amount": "45", "unit": "ml" }, { "ingredient_id": 36, "ingredient_name": "ライム・ジュース", "amount": "15", "unit": "ml" } ] }, { "cocktail_id": 12, "cocktail_name": "ジン・バック", "cocktail_name_english": "Gin Buck", "base_name": "ジン", "technique_name": "ビルド", "taste_name": "中口", "style_name": "ロング", "alcohol": 16, "top_name": "オール", "glass_name": "タンブラー", "type_name": "アルコール", "cocktail_digest": "雄鹿のようにキックの効いた一杯", "cocktail_desc": "甘みと酸味のバランスがとれジンジャー・エールの炭酸も加わっているため夏にピッタリの爽快なカクテル。", "recipe_desc": "グラスに氷を入れてジンとレモン・ジュースを注ぎステア(混ぜる)。その後冷えたジンジャーエールでグラスを満たし、炭酸が抜けないよう軽くステアする。", "recipes": [ { "ingredient_id": 1, "ingredient_name": "ジン", "amount": "45", "unit": "ml" }, { "ingredient_id": 37, "ingredient_name": "レモン・ジュース", "amount": "30", "unit": "ml" }, { "ingredient_id": 41, "ingredient_name": "ジンジャーエール", "amount": "", "unit": "FullUP" } ] }, { "cocktail_id": 13, "cocktail_name": "ジン・フィズ", "cocktail_name_english": "Gin Fizz", "base_name": "ジン", "technique_name": "ビルド", "taste_name": "中辛口", "style_name": "ロング", "alcohol": 16, "top_name": "オール", "glass_name": "タンブラー", "type_name": "アルコール", "cocktail_digest": "フィズの中でも代表的な一杯", "cocktail_desc": "1888年、アメリカ、ニューオーリンズの「インペリアル・キャビネット・サロン」のオーナーが初めて作ったとされるカクテルで、さっぱりと爽快な味わいが特徴。", "recipe_desc": "シェーカーに炭酸水以外の材料と氷を入れてシェイクし、氷を入れたグラスに注ぐ。その後冷えた炭酸水でグラスを満たし、炭酸が抜けないよう軽くステアする。", "recipes": [ { "ingredient_id": 1, "ingredient_name": "ジン", "amount": "45", "unit": "ml" }, { "ingredient_id": 37, "ingredient_name": "レモン・ジュース", "amount": "20", "unit": "ml" }, { "ingredient_id": 52, "ingredient_name": "シュガー・シロップ", "amount": "1", "unit": "tsp." }, { "ingredient_id": 33, "ingredient_name": "炭酸水", "amount": "", "unit": "FullUP" } ] }, { "cocktail_id": 14, "cocktail_name": "カミカゼ", "cocktail_name_english": "Kamikaze", "base_name": "ウォッカ", "technique_name": "シェイク", "taste_name": "中辛口", "style_name": "ロング", "alcohol": 27, "top_name": "オール", "glass_name": "オールドファッションドグラス", "type_name": "アルコール", "cocktail_digest": "さっぱりしたアメリカ生まれ", "cocktail_desc": "名前は旧日本海軍の神風特攻隊に由来するが、生まれはアメリカのカクテル。ホワイト・キュラソーの甘さにライムの酸味が加わりさっぱりとした味わい。シェイクした上で氷を入れたグラスに注ぐ少し珍しいスタイルを取る。", "recipe_desc": "シェーカーにすべての材料と氷を入れてシェイクし、氷を入れたグラスに注ぐ。", "recipes": [ { "ingredient_id": 2, "ingredient_name": "ウォッカ", "amount": "20", "unit": "ml" }, { "ingredient_id": 14, "ingredient_name": "ホワイト・キュラソー", "amount": "20", "unit": "ml" }, { "ingredient_id": 36, "ingredient_name": "ライム・ジュース", "amount": "20", "unit": "ml" } ] }, { "cocktail_id": 15, "cocktail_name": "スクリュー・ドライバー", "cocktail_name_english": "Screwdriver", "base_name": "ウォッカ", "technique_name": "ビルド", "taste_name": "中口", "style_name": "ロング", "alcohol": 13, "top_name": "オール", "glass_name": "タンブラー", "type_name": "アルコール", "cocktail_digest": "オレンジジュースとウォッカのシンプルで手軽なカクテル", "cocktail_desc": "油田の作業員がスクリュー・ドライバー(ねじ回し)で材料をかき混ぜたことからこの名がついた。ウォッカとオレンジジュースを混ぜたシンプルなカクテルで家でも簡単に作れる。あえてマドラーを添えることでねじ回しで混ぜていたことの名残を現している。", "recipe_desc": "グラスに氷を入れてウォッカ注ぎ、その後オレンジ・ジュースでグラスを満たし、ステア(混ぜる)する。最後にマドラーを添える。", "recipes": [ { "ingredient_id": 2, "ingredient_name": "ウォッカ", "amount": "45", "unit": "ml" }, { "ingredient_id": 34, "ingredient_name": "オレンジ・ジュース", "amount": "", "unit": "FullUP" } ] }, { "cocktail_id": 16, "cocktail_name": "スレッジ・ハンマー", "cocktail_name_english": "Sledge Hammer", "base_name": "ウォッカ", "technique_name": "シェイク", "taste_name": "辛口", "style_name": "ショート", "alcohol": 28, "top_name": "食前", "glass_name": "カクテルグラス", "type_name": "アルコール", "cocktail_digest": "大型ハンマーで殴られるようなシンプルで強烈な味わい", "cocktail_desc": "スレッジハンマーとは両手持ちの大型ハンマーで、カクテルの名前の通りウォッカとライムのシンプルで切れのある強烈な組み合わせでぶん殴られるような味わい。ぜひ搾りたての生ライムジュースを使いたい。", "recipe_desc": "シェーカーにすべての材料と氷を入れてシェイクし、グラスに注ぐ。", "recipes": [ { "ingredient_id": 2, "ingredient_name": "ウォッカ", "amount": "45", "unit": "ml" }, { "ingredient_id": 36, "ingredient_name": "ライム・ジュース", "amount": "15", "unit": "ml" }, { "ingredient_id": 52, "ingredient_name": "シュガー・シロップ", "amount": "1", "unit": "tsp." } ] }, { "cocktail_id": 17, "cocktail_name": "ソルティ・ドッグ", "cocktail_name_english": "Salty Dog", "base_name": "ウォッカ", "technique_name": "ビルド", "taste_name": "中口", "style_name": "ロング", "alcohol": 11, "top_name": "オール", "glass_name": "オールドファッションドグラス", "type_name": "アルコール", "cocktail_digest": "スノースタイルが楽しいシンプルなカクテル", "cocktail_desc": "船の甲板員を意味するスラングが名前の由来。スノースタイルの塩の口当たりと味わいの変化が楽しいカクテル。", "recipe_desc": "グラスの縁をレモンで濡らし、塩をつけてスノースタイルにする。その後ウォッカとグレープフルーツ・ジュースをグラスに注ぎステア(混ぜる)する。", "recipes": [ { "ingredient_id": 2, "ingredient_name": "ウォッカ", "amount": "45", "unit": "ml" }, { "ingredient_id": 42, "ingredient_name": "グレープフルーツ・ジュース", "amount": "", "unit": "FullUP" }, { "ingredient_id": 56, "ingredient_name": "塩", "amount": "", "unit": "適量" } ] }, { "cocktail_id": 18, "cocktail_name": "バラライカ", "cocktail_name_english": "Balalaika", "base_name": "ウォッカ", "technique_name": "シェイク", "taste_name": "中辛口", "style_name": "ショート", "alcohol": 30, "top_name": "オール", "glass_name": "カクテルグラス", "type_name": "アルコール", "cocktail_digest": "ロシアの民族楽器をイメージしたウォッカベースのカクテル", "cocktail_desc": "バラライカとはロシアの民族楽器のこと。口当たりがよく切れのある味わい。ベースを変えることで他の様々なカクテルとなる。", "recipe_desc": "シェーカーにすべての材料と氷を入れてシェイクし、グラスに注ぐ。", "recipes": [ { "ingredient_id": 2, "ingredient_name": "ウォッカ", "amount": "30", "unit": "ml" }, { "ingredient_id": 14, "ingredient_name": "ホワイト・キュラソー", "amount": "15", "unit": "ml" }, { "ingredient_id": 37, "ingredient_name": "レモン・ジュース", "amount": "15", "unit": "ml" } ] }, { "cocktail_id": 19, "cocktail_name": "ブルドッグ", "cocktail_name_english": "Bulldog", "base_name": "ウォッカ", "technique_name": "ビルド", "taste_name": "中口", "style_name": "ロング", "alcohol": 11, "top_name": "オール", "glass_name": "オールドファッションドグラス", "type_name": "アルコール", "cocktail_digest": "尻尾(塩)のないソルティドッグはブルドッグ", "cocktail_desc": "ソルティ・ドッグをスノースタイルにせずにウォッカをグレープフルーツ・ジュースで割ったシンプルなカクテル。名前の由来として塩を抜いたソルティ・ドッグ→しっぽがない犬→ブルドッグとなったと言われる。", "recipe_desc": "グラスに氷を入れてウォッカ注ぎ、その後グレープフルーツ・ジュースでグラスを満たし、ステア(混ぜる)する。", "recipes": [ { "ingredient_id": 2, "ingredient_name": "ウォッカ", "amount": "45", "unit": "ml" }, { "ingredient_id": 42, "ingredient_name": "グレープフルーツ・ジュース", "amount": "", "unit": "FullUP" } ] }, { "cocktail_id": 20, "cocktail_name": "モスコ・ミュール", "cocktail_name_english": "Moscow Mule", "base_name": "ウォッカ", "technique_name": "ビルド", "taste_name": "中口", "style_name": "ロング", "alcohol": 11, "top_name": "オール", "glass_name": "タンブラー", "type_name": "アルコール", "cocktail_digest": "アメリカで流行した「モスクワのラバ」", "cocktail_desc": "ラバのひと蹴りと呼ばれる、ウォッカとジンジャーエールとライムのさっぱりとした飲みやすいカクテル。辛口のジンジャーエールでよりピリッとした味わいに。", "recipe_desc": "グラスに氷を入れてウォッカとコーディアル・ライム・ジュース注ぎ、その後ジンジャーエールでグラスを満たし、軽くステア(混ぜる)する。", "recipes": [ { "ingredient_id": 2, "ingredient_name": "ウォッカ", "amount": "45", "unit": "ml" }, { "ingredient_id": 43, "ingredient_name": "コーディアル・ライム・ジュース", "amount": "1", "unit": "tsp." }, { "ingredient_id": 41, "ingredient_name": "ジンジャーエール", "amount": "", "unit": "FullUP" } ] } ] }
パラメータを指定した場合のリクエスト・レスポンス例1
https://cocktail-f.com/api/v1/cocktails?word=マティーニ&page=1&limit=3
{ "status": "0000", "total_pages": 2, "current_page": 1, "cocktails": [ { "cocktail_id": 1, "cocktail_name": "マティーニ", "cocktail_name_english": "Martini", "base_name": "ジン", "technique_name": "ステア", "taste_name": "辛口", "style_name": "ショート", "alcohol": 42, "top_name": "食前", "glass_name": "カクテルグラス", "type_name": "アルコール", "cocktail_digest": "カクテルの王様", "cocktail_desc": "ジンの辛味とドライベルモットの香りが絶妙なカクテルの王様。時代が進むにつれ辛口へと変化している。使用するお酒の種類や配合が無数にあるため、バーによって味が異なると言われている。カクテル好きなら1度は味わっておきたい一杯。", "recipe_desc": "ジンとドライベルモットをミキシンググラスでステアし、グラスに注ぐ。オリーブをカクテルピックに刺して沈め、仕上げにレモンピールをふる。", "recipes": [ { "ingredient_id": 1, "ingredient_name": "ジン", "amount": "50", "unit": "ml" }, { "ingredient_id": 15, "ingredient_name": "ドライ・ベルモット", "amount": "10", "unit": "ml" }, { "ingredient_id": 47, "ingredient_name": "オリーブ", "amount": "1", "unit": "個" }, { "ingredient_id": 48, "ingredient_name": "レモン・ピール", "amount": "", "unit": "適量" } ] }, { "cocktail_id": 8, "cocktail_name": "ウォッカ・マティーニ", "cocktail_name_english": "Vodka Martini", "base_name": "ウォッカ", "technique_name": "ステア", "taste_name": "辛口", "style_name": "ショート", "alcohol": 36, "top_name": "食前", "glass_name": "カクテルグラス", "type_name": "アルコール", "cocktail_digest": "ベースをウォッカに変えスムースでソフトな飲み口のマティーニ", "cocktail_desc": "使用する材料をドライ・ジンをウォッカに変えたマティーニ。ウォッカを使うことでジン特有のクセがなくなり、ややソフトな味わいになる。", "recipe_desc": "ウォッカとドライベルモットをミキシンググラスでステアし、グラスに注ぐ。オリーブをカクテルピックに刺して沈め、仕上げにレモンピールをふる。", "recipes": [ { "ingredient_id": 2, "ingredient_name": "ウォッカ", "amount": "45", "unit": "ml" }, { "ingredient_id": 15, "ingredient_name": "ドライ・ベルモット", "amount": "15", "unit": "ml" } ] }, { "cocktail_id": 83, "cocktail_name": "クラシック・ドライ・マティーニ", "cocktail_name_english": "Classic Dry Martini", "base_name": "ジン", "technique_name": "ステア", "taste_name": "辛口", "style_name": "ショート", "alcohol": 40, "top_name": "食前", "glass_name": "カクテルグラス", "type_name": "アルコール", "cocktail_digest": "現在の辛口マティーニの元祖", "cocktail_desc": "カクテルの王様マティーニは時代が進むに連れ辛口になったが、その辛口への変化のスタートと言えるべきレシピがこのクラシック・ドライ・マティーニ。現在のマティーニに比べるとドライ・ベルモットの割合が多く、飲みやすい仕上がりとなっている。", "recipe_desc": "すべての材料をミキシンググラスでステアし、グラスに注ぐ。", "recipes": [ { "ingredient_id": 1, "ingredient_name": "ジン", "amount": "45", "unit": "ml" }, { "ingredient_id": 15, "ingredient_name": "ドライ・ベルモット", "amount": "15", "unit": "ml" }, { "ingredient_id": 21, "ingredient_name": "オレンジ・ビターズ", "amount": "1", "unit": "ml" } ] } ] }
パラメータを指定した場合のリクエスト・レスポンス例2
https://cocktail-f.com/api/v1/cocktails?alcohol_from=1&alcohol_to=5
{ "status": "0000", "total_pages": 1, "current_page": 1, "cocktails": [ { "cocktail_id": 34, "cocktail_name": "アプリコット・クーラー", "cocktail_name_english": "Apricot Cooler", "base_name": "リキュール", "technique_name": "シェイク", "taste_name": "中甘口", "style_name": "ロング", "alcohol": 5, "top_name": "オール", "glass_name": "コリンズグラス", "type_name": "アルコール", "cocktail_digest": "アプリコット・ブランデーを使ったクーラースタイルのカクテル", "cocktail_desc": "アプリコット・ブランデーのまろやかな香りと、炭酸のさっぱりとした味わいで女性に人気のカクテル。", "recipe_desc": "シェーカーに炭酸水以外の材料と氷を入れてシェイクし、氷を入れたグラスに注ぐ。その後冷えた炭酸水でグラスを満たし、炭酸が抜けないよう軽くステアする。", "recipes": [ { "ingredient_id": 16, "ingredient_name": "アプリコット・ブランデー", "amount": "45", "unit": "ml" }, { "ingredient_id": 37, "ingredient_name": "レモン・ジュース", "amount": "20", "unit": "ml" }, { "ingredient_id": 49, "ingredient_name": "グレナデン・シロップ", "amount": "1", "unit": "tsp." }, { "ingredient_id": 33, "ingredient_name": "炭酸水", "amount": "", "unit": "適量" } ] }, { "cocktail_id": 47, "cocktail_name": "シャンディー・ガフ", "cocktail_name_english": "Shandy Gaff", "base_name": "ビール", "technique_name": "ビルド", "taste_name": "中口", "style_name": "ロング", "alcohol": 3, "top_name": "オール", "glass_name": "ゴブレット", "type_name": "アルコール", "cocktail_digest": "ビールとジンジャーエールの爽快な飲み口", "cocktail_desc": "ビールの苦味をジンジャーエールで抑え、ダブルの炭酸で爽快感もあるビアカクテル。度数も控えめなので、お酒が苦手な人でも飲みやすい。", "recipe_desc": "グラスにビールを注いだ後、ビールの泡が崩れないようにジンジャーエールを静かに注ぐ。最後に軽くステア(混ぜる)する。", "recipes": [ { "ingredient_id": 9, "ingredient_name": "ビール", "amount": "1/2", "unit": "glass" }, { "ingredient_id": 41, "ingredient_name": "ジンジャーエール", "amount": "1/2", "unit": "glass" } ] }, { "cocktail_id": 48, "cocktail_name": "レッド・アイ", "cocktail_name_english": "Red Eye", "base_name": "ビール", "technique_name": "ビルド", "taste_name": "中口", "style_name": "ロング", "alcohol": 3, "top_name": "オール", "glass_name": "ゴブレット", "type_name": "アルコール", "cocktail_digest": "トマト・ジュースの酸味がマッチしたビアカクテル", "cocktail_desc": "二日酔いの目が赤くなった状態からこの名がついたと言われている。トマト・ジュースが爽やかで迎え酒としても有名。", "recipe_desc": "グラスにビールを注いだ後、トマト・ジュースを注ぐ。最後に軽くステア(混ぜる)する。", "recipes": [ { "ingredient_id": 9, "ingredient_name": "ビール", "amount": "1/2", "unit": "glass" }, { "ingredient_id": 39, "ingredient_name": "トマト・ジュース", "amount": "1/2", "unit": "glass" } ] }, { "cocktail_id": 63, "cocktail_name": "ディタモーニ", "cocktail_name_english": "Ditamoni", "base_name": "リキュール", "technique_name": "ビルド", "taste_name": "中甘口", "style_name": "ロング", "alcohol": 4, "top_name": "オール", "glass_name": "コリンズグラス", "type_name": "アルコール", "cocktail_digest": "ライチの味わいを爽やかに口当たりよくいただく", "cocktail_desc": "チャイナ・ブルーと同じくライチとグレープフルーツをあわせたカクテル。トニック・ウォーターで割っている分炭酸で喉ごし爽やかな味わいで女性に人気がある。「ディタ」はライチリキュールの代表的な銘柄だが、ディタ以外のライチリキュールを使っても問題ない。", "recipe_desc": "氷を入れたグラスにトニック・ウォーター以外を入れてステア(混ぜる)する。その後冷えたトニック・ウォーターでグラスを満たし、炭酸が抜けないよう軽くステアする。", "recipes": [ { "ingredient_id": 20, "ingredient_name": "ライチ・リキュール", "amount": "30", "unit": "ml" }, { "ingredient_id": 42, "ingredient_name": "グレープフルーツ・ジュース", "amount": "30", "unit": "ml" }, { "ingredient_id": 35, "ingredient_name": "トニック・ウォーター", "amount": "", "unit": "FullUP" } ] }, { "cocktail_id": 77, "cocktail_name": "スプモーニ", "cocktail_name_english": "Spumoni", "base_name": "リキュール", "technique_name": "ビルド", "taste_name": "中甘口", "style_name": "ロング", "alcohol": 5, "top_name": "オール", "glass_name": "コリンズグラス", "type_name": "アルコール", "cocktail_digest": "カンパリを使った代表的なカクテル", "cocktail_desc": "イタリア語の「泡立てる」という単語から名がついたと言われる。カンパリの苦味をグレープフルーツのとトニックウォーターがさっぱりと飲みやすく仕立てている。カンパリを使った色合いも美しい。", "recipe_desc": "グラスに氷を入れてカンパリとグレープフルーツ・ジュースを注ぎステア(混ぜる)。その後冷えたトニック・ウォーターでグラスを満たし、炭酸が抜けないよう軽くステアする。", "recipes": [ { "ingredient_id": 22, "ingredient_name": "カンパリ", "amount": "30", "unit": "ml" }, { "ingredient_id": 42, "ingredient_name": "グレープフルーツ・ジュース", "amount": "45", "unit": "ml" }, { "ingredient_id": 35, "ingredient_name": "トニック・ウォーター", "amount": "", "unit": "適量" } ] } ] }
エラーコード | エラー詳細 | 備考 |
---|---|---|
E001 | wordのフォーマットが不正です。 | |
E002 | baseのフォーマットが不正です。 | |
E003 | techniqueのフォーマットが不正です。 | |
E004 | tasteのフォーマットが不正です。 | |
E005 | alcohol_fromのフォーマットが不正です。 | |
E006 | alcohol_toのフォーマットが不正です。 | |
E007 | alcohol_fromとalcohol_toの前後関係が不正です。 | |
E008 | styleのフォーマットが不正です。 | |
E009 | tpoのフォーマットが不正です。 | |
E010 | glassのフォーマットが不正です。 | |
E011 | colorのフォーマットが不正です。 | |
E012 | tagのフォーマットが不正です。 | |
E020 | pageのフォーマットが不正です。 | |
E021 | limitのフォーマットが不正です。 | |
E999 | システムエラー |
idを指定して単一のカクテル情報を取得します。idはカクテル検索APIのレスポンス項目として取得可能な「カクテルID」を指定してください。
リクエスト先URL
https://cocktail-f.com/api/v1/cocktails/[:id]
指定可能なパラメータはありません。
レスポンス項目一覧
パラメータ名 | パラメータ | 親要素 | 備考 |
---|---|---|---|
ステータス | status | なし | 正常時:0000 異常時は下記のエラー一覧を参照 |
エラー詳細 | error_detail | なし | 異常時のみ |
総ページ数 | total_pages | なし | 正常時のみ |
現在のページ番号 | current_page | なし | 正常時のみ |
カクテルID | cocktail_id | なし | 後述のカクテル情報紹介APIのid値として使用する値 |
カクテル名 | cocktail_name | なし | |
カクテル英語名 | cocktail_name_english | なし | |
ベース | base_name | なし | |
技法 | technique_name | なし | |
味わい | taste_name | なし | |
スタイル | style_name | なし | |
アルコール度数 | alcohol | なし | |
TPO | tpo_name | なし | |
グラス | glass_name | なし | |
カクテル要約 | cocktail_digest | なし | |
カクテル説明 | cocktail_desc | なし | |
レシピ情報リスト | recipes | なし | |
材料ID | ingredient_id | recipes | |
材料名 | ingredient_name | recipes | |
分量 | amount | recipes | 単位が「適量」「FullUP」の場合はnullを返却 |
単位 | unit | recipes | 単位として返却しうる値:ml,tsp.,dash,枚,個,適量,FullUP,glass |
リクエスト・レスポンス例
https://cocktail-f.com/api/v1/cocktails/1
{ "status": "0000", "cocktail": { "cocktail_id": 1, "cocktail_name": "マティーニ", "cocktail_name_english": "Martini", "base_name": "ジン", "technique_name": "ステア", "taste_name": "辛口", "style_name": "ショート", "alcohol": 42, "top_name": "食前", "glass_name": "カクテルグラス", "type_name": "アルコール", "cocktail_digest": "カクテルの王様", "cocktail_desc": "ジンの辛味とドライベルモットの香りが絶妙なカクテルの王様。時代が進むにつれ辛口へと変化している。使用するお酒の種類や配合が無数にあるため、バーによって味が異なると言われている。カクテル好きなら1度は味わっておきたい一杯。", "recipe_desc": "ジンとドライベルモットをミキシンググラスでステアし、グラスに注ぐ。オリーブをカクテルピックに刺して沈め、仕上げにレモンピールをふる。", "recipes": [ { "ingredient_id": 1, "ingredient_name": "ジン", "amount": "50", "unit": "ml" }, { "ingredient_id": 15, "ingredient_name": "ドライ・ベルモット", "amount": "10", "unit": "ml" }, { "ingredient_id": 47, "ingredient_name": "オリーブ", "amount": "1", "unit": "個" }, { "ingredient_id": 48, "ingredient_name": "レモン・ピール", "amount": null, "unit": "適量" } ] } }
エラーコード | エラー詳細 | 備考 |
---|---|---|
E030 | idのフォーマットが不正です。 | |
E800 | idの指定が不正です。 | 指定のidのカクテルが存在しない場合 |
E999 | システムエラー |