> For the complete documentation index, see [llms.txt](https://docs.barhelper.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.barhelper.app/settings/custom-keg-monitor.md).

# 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

![](/files/-MjJQcEket7xG2p-UmsM)

1\) Trykk på Generate API Key

![](/files/-MjJQo8scaaR4mEz8WNk)

1\) Kopier API nøkkelen

![](/files/-MjJQwTP1fsxkcEClpzr)

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&#x20;

```
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](<&#xA;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}<br>

<mark style="color:green;">`POST`</mark> `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) |

{% tabs %}
{% tab title="200 " %}

```
New amount: 12.3
```

{% endtab %}
{% endtabs %}

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

![](/files/-MjJ_0igo5Aw_nkxmJBM)

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

![](/files/-MjJ_rd5BHmvI1g3maQn)

1\) Velg monitoren din

![](/files/-MjJaGeXNf0eO_aY7eRp)

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>

<br>