pour.fyipour.fyi developer resources
A small, explicit public surface.
These resources describe what agents and developers can safely discover and call without access to private account data.
Machine-readable files
llms.txt is the concise site map and includes specific when-to-use guidance. llms-full.txt adds product and privacy context. The OpenAPI YAML specification and OpenAPI JSON specification document the public health endpoint and the authentication boundary for data exports. The ARD catalog makes these resources discoverable by agent registries.
Markdown content negotiation
Public pages accept Accept: text/markdown. Markdown responses use Content-Type: text/markdown; charset=utf-8 and Vary: Accept, Accept-Encoding, so an edge cache can keep HTML and Markdown representations separate. Unknown public paths return HTTP 404 with a short Markdown recovery body.
Authentication boundary
The dashboard, drink history, body settings, goals, imports, exports, statistics, calendar, BAC timeline, and subscription data are private. They require a signed-in Better Auth session. Agents must not attempt to bypass that boundary or infer private user data. The public overview and this page provide an ungated summary instead.
Public endpoint
GET /api/health returns a small JSON service-health response. Authenticated JSON, CSV, and AlcoDroid-compatible export endpoints are described in the OpenAPI document as protected resources and return HTTP 401 without a valid session.