BD Event

BD Event

Tài liệu dành cho nhà phát triển

BD Event — nền tảng tổng hợp sự kiện B2B tại Việt Nam — công bố tài nguyên phát triển công khai: API mô tả bằng OpenAPI, tài liệu xác thực, webhook Telegram và giao thức Markdown cho AI agents.

Tài nguyên máy đọc được

Mọi tài nguyên phát triển đều ở URL cố định, dễ đoán và được liệt kê trong llms.txt. Agent có thể đọc trực tiếp OpenAPI spec, tài liệu xác thực và webhook mà không cần đăng nhập.

API công khai

API JSON hỗ trợ cộng đồng sự kiện (RSVP, bình luận) và đề xuất sự kiện. Xem /docs/api.md (tham chiếu) và /docs/openapi.json (OpenAPI 3.0). Các thao tác ghi cần CSRF token từ bootstrap; truy vấn đọc đơn giản nên dùng Markdown của trang danh mục.

Xác thực (Auth)

Xác thực dựa trên CSRF token theo phiên cookie (GET action=bootstrap trả csrf). Không có API key công khai; không có endpoint nào yêu cầu OAuth. Xem /docs/auth.md.

Webhook Telegram

Bot Telegram nội bộ nhận event qua webhook /api/telegram.php với header X-Telegram-Bot-Api-Secret-Token. Xem /docs/webhooks.md.

Giao thức Markdown

Các trang nội dung phục vụ cả HTML lẫn Markdown qua Accept: text/markdown (chuẩn acceptmarkdown.com) — xem /docs/markdown.md. Tệp .md tĩnh được phục vụ với Content-Type text/markdown.

Danh mục tài nguyên