BD Event

BD Event

Developer Documentation

BD Event — a curated B2B event directory for Vietnam — publishes public developer resources: an OpenAPI-described API, authentication docs, a Telegram webhook and a Markdown protocol for AI agents.

Machine-readable resources

All developer resources live at fixed, predictable URLs and are listed in llms.txt. Agents can read the OpenAPI spec, authentication guide and webhook docs directly — no login required.

Public API

The JSON API powers event community features (RSVP, comments) and event submissions. See /docs/api.md (reference) and /docs/openapi.json (OpenAPI 3.0). Write operations require a CSRF token from bootstrap; for simple read-only queries prefer the Markdown version of the catalog pages.

Authentication

Authentication is a per-session cookie with a CSRF token (GET action=bootstrap returns csrf). There is no public API key and no OAuth. See /docs/auth.md.

Telegram webhook

The internal Telegram bot receives events via the /api/telegram.php webhook using the X-Telegram-Bot-Api-Secret-Token header. See /docs/webhooks.md.

Markdown protocol

Content pages serve both HTML and Markdown via Accept: text/markdown (acceptmarkdown.com convention) — see /docs/markdown.md. Static .md files are served with Content-Type: text/markdown.

Resource index