{"id":20244020,"url":"https://github.com/hud0shnik/vallhallaapi","last_synced_at":"2026-01-05T04:03:33.456Z","repository":{"id":65649261,"uuid":"594721302","full_name":"hud0shnik/vallhallaapi","owner":"hud0shnik","description":"VA-11 Hall-A recipes API 🥃","archived":false,"fork":false,"pushed_at":"2024-09-09T11:46:53.000Z","size":195,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-11-14T09:11:54.570Z","etag":null,"topics":["api-rest","docker","go","postgresql","vercel"],"latest_commit_sha":null,"homepage":"https://vall-halla-api.vercel.app","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hud0shnik.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-01-29T12:50:37.000Z","updated_at":"2024-11-11T20:25:24.000Z","dependencies_parsed_at":"2023-09-05T03:30:26.839Z","dependency_job_id":"46de9cbf-8d95-477b-88f5-857f9a996382","html_url":"https://github.com/hud0shnik/vallhallaapi","commit_stats":{"total_commits":119,"total_committers":1,"mean_commits":119.0,"dds":0.0,"last_synced_commit":"6cb7d0e0919c0182c00fed86bf61ae6668bfa111"},"previous_names":["hud0shnik/vallhallaapi","hud0shnik/vallhalla-api"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hud0shnik%2Fvallhallaapi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hud0shnik%2Fvallhallaapi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hud0shnik%2Fvallhallaapi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hud0shnik%2Fvallhallaapi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hud0shnik","download_url":"https://codeload.github.com/hud0shnik/vallhallaapi/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":233832504,"owners_count":18737210,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api-rest","docker","go","postgresql","vercel"],"created_at":"2024-11-14T09:11:18.418Z","updated_at":"2025-09-22T07:31:04.159Z","avatar_url":"https://github.com/hud0shnik.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🦾 VallHalla-api 🥃\n\n\u003ci\u003e\u003cb\u003eValhalla-api\u003c/b\u003e\u003c/i\u003e provides fast access to the database of drink recipes from the game \u003cb\u003e\"VA-11 Hall-A: Cyberpunk Bartender Action\"\u003c/b\u003e\n\n## Overview\n\n- [Overview](#overview)\n- [Request](#request)\n- [Structures](#structures)\n- [Types](#types)\n- [Shortcuts](#shortcuts)\n- [Samples](#samples)\n\n### Request\n  \n``` Elixir\nhttps://vall-halla-api.vercel.app/api/search\n``` \n\nParameter       | Value type | Description   \n----------------|------------|-------------------------------------\nname            |   string   | search by names ('%VALUE%')\nprice           |    int     | search by prices (==)\nalcoholic       |   string   |\nice             |   string   |\nflavour         |   string   | search by flavours (==)\ntype            |   string   | search by types ('%VALUE%')\nshortcut        |   string   | search by shortcuts ('%VALUE%')\nrecipe          |   string   | search by recipes ('%VALUE%')\ndescription     |   string   | search by descriptions ('%VALUE%')\n\n\u003cp\u003eFor example,\u003c/br\u003e\"https://vall-halla-api.vercel.app/api/search?alcoholic=no\u0026flavour=spicy\" - all non-alcoholic spicy drinks,\u003c/br\u003e\n\"https://vall-halla-api.vercel.app/api/search?name=piano\" - \"Piano Man\" and \"Piano Woman\" recipes,\u003c/br\u003e\n\"https://vall-halla-api.vercel.app/api/search?recipe=aged\" - all aged drinks,\u003c/br\u003e\n\"https://vall-halla-api.vercel.app/api/search?type=promo\u0026shortcut=3xT\" - all promo drinks with 3 Karmotrine\u003c/p\u003e   \n\n### Structures \n\n#### Response\n\nField                       |       Type         | Description\n----------------------------|--------------------|------------\nsuccess                     |       bool         | response status\nerror                       |      string        | \nresult                      |     []Drink        | slice of recipes\n\n\n#### Drink\n\nField                       |       Type         | Description\n----------------------------|--------------------|------------\nname                        |      string        |\nprice                       |       int          |\nalcoholic                   |      string        | \"Yes\", \"No\" or \"Optional\"\nice                         |      string        | \"Yes\" or \"No\"\nflavour                     |      string        | may be \"N/A\"\nprimary_type                |      string        |\nsecondary_type              |      string        |\nshortcut                    |      string        | also may be \"N/A\"\n\n\n### Types\n\nType                     |                                    Values       \n-------------------------|------------------------------------------------------------------------\nprimary_type             | \"Bottled\", \"Classic\", \"Classy\", \"Girly\", \"Manly\" or \"Promo\"\nsecondary_Type           | \"Bland\", \"Burning\", \"Happy\", \"N/A\", \"Sobering\", \"Soft\", \"Strong\" or \"Vintage\"\n\n\n### Shortcuts\n\nShortcuts   |    Action   \n------------|-------------------- \nQ           | Add one Adelhyde\nW           | Add one Bronson Extract\nE           | Add one Powdered Delta\nR           | Add one Flanergide\nT           | Add one Karmotrine (alcoholic component)\nA           | Toggle ice\nS           | Toggle aging\n\n\u003cp\u003e For example, \u003ci\u003e\"2xQ, 3xW, 5xE, 5xR, 3xT, A, all mixed.\"\u003c/i\u003e means \u003ci\u003e\"2 Adelhyde, 3 Bronson Extract, 5 Powdered Delta, 5 Flanergide and 3 Karmotrine, all on the rocks and mixed.\"\u003c/i\u003e\u003c/p\u003e\n\nYou can also use route \u003cb\u003e\"/info\"\u003c/b\u003e instead of \u003cb\u003e\"/search\"\u003c/b\u003e to get more information about drink (with description and full recipe). Parameters are the same.\n\n\n### Samples\n\n#### Request\n``` Elixir\nhttps://vall-halla-api.vercel.app/api/search?type=manly\u0026alcoholic=optional\n``` \n\n#### Response\n\n``` Json\n{\n  \"success\": true,\n  \"error\": \"\",\n  \"result\": [\n    {\n      \"name\": \"Crevice Spike\",\n      \"price\": 140,\n      \"alcoholic\": \"Optional\",\n      \"ice\": \"No\",\n      \"flavour\": \"Sour\",\n      \"primary_type\": \"Manly\",\n      \"secondary_type\": \"Sobering\",\n      \"shortcut\": \"2xE, 4xR, optional T, all blended.\"\n    },\n    {\n      \"name\": \"Gut Punch\",\n      \"price\": 80,\n      \"alcoholic\": \"Optional\",\n      \"ice\": \"No\",\n      \"flavour\": \"Bitter\",\n      \"primary_type\": \"Manly\",\n      \"secondary_type\": \"Strong\",\n      \"shortcut\": \"5xW, 1xR, optional T, S, all mixed.\"\n    }\n  ]\n}\n```\n\n#### Request\n\n``` Elixir\nhttps://vall-halla-api.vercel.app/api/info?flavour=spicy\u0026recipe=bronson%20extract\n``` \n\n#### Response\n\n``` Json\n{\n  \"success\": true,\n  \"error\": \"\",\n  \"result\": [\n    {\n      \"name\": \"Bleeding Jane\",\n      \"price\": 200,\n      \"alcoholic\": \"No\",\n      \"ice\": \"No\",\n      \"flavour\": \"Spicy\",\n      \"primary_type\": \"Classic\",\n      \"secondary_type\": \"Sobering\",\n      \"recipe\": \"1 Bronson Extract, 3 Powdered Delta and 3 Flanergide. All blended.\",\n      \"shortcut\": \"1xW, 3xE, 3xR, all blended.\",\n      \"description\": \"Say the name of this drink three times in front of a mirror and you'll look like a fool.\"\n    },\n    {\n      \"name\": \"Marsblast\",\n      \"price\": 170,\n      \"alcoholic\": \"Yes\",\n      \"ice\": \"No\",\n      \"flavour\": \"Spicy\",\n      \"primary_type\": \"Manly\",\n      \"secondary_type\": \"Strong\",\n      \"recipe\": \"6 Bronson Extract, 1 Powdered Delta, 4 Flanergide and 2 Karmotrine. All blended.\",\n      \"shortcut\": \"6xW, 1xE, 4xR, 2xT, all blended.\",\n      \"description\": \"One of these is enough to leave your face red like the actual planet.\"\n    }\n  ]\n}\n```\n\n\u003cimg src=\"https://wakatime.com/badge/user/ee2709af-fc5f-498b-aaa1-3ea47bf12a00/project/ca6a9f63-8582-4243-905e-900ec35cede8.svg?style=for-the-badge\"\u003e\n\n[![License - BSD 3-Clause](https://img.shields.io/static/v1?label=License\u0026message=BSD+3-Clause\u0026color=%239a68af\u0026style=for-the-badge)](/LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhud0shnik%2Fvallhallaapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhud0shnik%2Fvallhallaapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhud0shnik%2Fvallhallaapi/lists"}