taps

Changed on

Manually records a drink (or spill) against this tap's keg.

Returns the new drink (201), or no content (204) when recorded as a spill.

post/api/taps/{id}/record-drink

Request

  • The document declares no server URL.
  • Auth: one of:
    • HTTP basic
    • API key in cookie sessionid

Path parameters

idinteger required

A unique integer value identifying this keg tap.

Request body

volume_mlnumber double required
usernamestring
pour_timestring date-time nullable
durationinteger
shoutstring
spilledboolean

Response

idinteger required
ticksinteger required

Flow sensor ticks, never changed once recorded.

volume_mlnumber double required

Calculated (or set) Drink volume.

timestring date-time required

Date and time of pour.

durationinteger required

Time in seconds taken to pour this Drink.

session_idinteger nullable required

Session where this Drink is grouped.

shoutstring nullable

Comment from the drinker at the time of the pour.

Changes

  • 8d1d025a79e9Revision changes
    • info

      removed the required write-only property keg/allOf[Keg]/beverage/allOf[Beverage]/producer_id from the response with the status