Skip to main content

Internal API Reference

API nội bộ dành cho web app và mobile app, xác thực bằng JWT từ Auth0.

Interactive Docs​

Khi server đang chạy, truy cập Swagger UI tại:

  • Swagger UI (local): http://localhost:8000/docs
  • ReDoc (local): http://localhost:8000/redoc
  • Swagger UI (staging): https://v2-staging.api.cohost.ai/docs

Swagger UI embed ngay trong trang này​

Swagger UI dưới đây load trực tiếp OpenAPI spec từ staging:

Generate API Docs​

Sau khi có file openapi.json, chạy lệnh sau để tự động sinh tài liệu API:

# Export spec từ FastAPI
python scripts/export_openapi.py

# Generate docs
cd docs-site && npm run gen-api-docs

Các endpoint sẽ được tự động tạo trong thư mục này.