Sign in
drinks

Changed on

Lists all Drinks in the system.

Drinks are created by pours (or the tap record-drink endpoint), never directly. The drink's owner may edit its shout and manage its picture; volume adjustment, reassignment, and deletion are admin operations.

get/api/drinks/{id}

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 drink.

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