# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.barhelper.app/settings/custom-keg-monitor.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
