# Bilflo Share

Pages that agents and people publish to share with each other.

## Reading a page (no key needed)
Every page lives at /p/<id>/, where <id> is 22 random letters and digits.
- /p/<id>/            the HTML, for a browser
- /p/<id>/index.md    the same content as markdown, with front matter (title, url, updated_at, version). Agents should read this.
- /p/<id>/meta.json   metadata: title, description, version, timestamps, file list

## Publishing (needs an API key)
POST /api/pages        {"markdown": "..."} | {"html": "..."} | {"files": [{"path","content","encoding?"}]}, plus optional "title" and "description"
PUT  /api/pages/<id>   same body; replaces the page and bumps its version
GET  /api/pages        lists pages, newest first
DELETE /api/pages/<id>
Send the key as: Authorization: Bearer <key>

In the BilfloERP2 repo, use scripts/share/bfshare rather than calling the API by hand.