Custom Keg Monitor

Custom Keg Monitor er et system for å registrere tapping av øl. Custom Keg Monitor koples opp mot et fat, og på den måten holder man rede på hvor mye som er igjen i fatet. Måten dette fungerer på, er ved å registrere mengden som er tappet, og dermed vil systemet automatisk lagre dette i Bar Helper. Custom Keg monitor fungerer via et REST Api kall. Det vil si, vi sender informasjon til Bar Helper via HTTPS POST, så systemet som skal registrere tappingen må støtte dette. Det første vi må gjøre er å generere en API nøkkel. Denne skal brukes når vi kaller Bar Helper.

1) Trykk på Settings 2) Trykk på Bar settings

1) Trykk på Generate API Key

1) Kopier API nøkkelen

Når en har kopiert API nøkkelen, ha denne på et trykt sted. Det vil ikke være mulig å se denne nøkkelen flere ganger, hvis du mister den, så må du slette den og generere en ny.

Når vi kjører REST kallet så vil det automatisk bli opprettet en monitor med det navnet du har valgt i kallet. På videoen under så kan du se at den automatisk blir opprettet. https://www.loom.com/share/93b54836abe24e948a12c0d07ee6d8ce

Nå som vi har nøkkelen, så kan vi sette opp REST kallet. Dette kan gjøres på mange måter, her har vi vist det via cUrl

curl --location --request POST 'https://europe-west1-barhelper-app.cloudfunctions.net/api/customKegMon' \
--header 'authorization: THlGekhVlCZDpISzVRYlBDb0xBSHM4VGNwQVpzeWVLd25sYWI2UFZBNw==' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Custom Keg Monitor By Amount",
    "amount": 460,
    "type": "ml"
}'

curl --location --request POST 'https://europe-west1-barhelper-app.cloudfunctions.net/api/customKegMon' \
--header 'authorization: THlGekhVlCZDpISzVRYlBDb0xBSHM4VGNwQVpzeWVLd25sYWI2UFZBNw==' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Custom Keg Monitor by Volume",
    "volume": 12.1,
    "type": "l"
}'

I type velger vi volum-enheten. Her kan du velge mellom følgende: 'mm3' | 'cm3' | 'ml' | 'l' | 'kl' | 'm3' | 'km3' | 'cl' | 'dl' | 'krm' | 'tsk' | 'msk' | 'kkp' | 'glas' | 'kanna' | 'tsp' | 'Tbs' | 'in3' | 'fl-oz' | 'cup' | 'pnt' | 'qt' | 'gal' | 'ft3' | 'yd3'

Denne returnerer JSON objekt med data og melding

{
"volume: 12.1"
"prevKegAmount": 14,
"newKegAmount": 12.1,
"success": true,
"message": "Keg Monitor updated successfully"
}

eller 

{
"amount: 0.46"
"prevKegAmount": 14000,
"newKegAmount": 13540,
"success": true,
"message": "Keg Monitor updated successfully"
}

Url: https://europe-west1-barhelper-app.cloudfunctions.net/api/customKegMon Method: POST Headers: authorization: BarHelper API key Content-Type: application/json Body format: json Body: { "name": "navnet du vil bruke", amout: mengden-i-milliliter}

POST https://europe-west1-barhelper-app.cloudfunctions.net/api/customKegMon

Headers

Name	Type	Description
Content-Type	string	application/json
authorization	string	The API Key from Bar Settings

Request Body

Name	Type	Description
	object	Navnet på monitoren og mengden som er tappet (i milliliter)

200

New amount: 12.3

1) Her kjører vi cUrl kommandoen 2) Her dukker monitoren opp

Nå som vi har monitoren så kan vi knytte denne til et tappetårn på vanlig måte. 1) Trykk på Taps, deretter på + nede i hjørnet 2) Velg Custom Keg monitor

1) Velg monitoren din

Du har nå laget en Custom Keg Monitor og er klar til å bruke denne. Her er et eksempel på hvordan det fungerer når den er mappet til et tappetårn. https://www.loom.com/share/c5a080f9591c46c1b9c286ce0efcb6ea