Fusion
83f94b1f09
Add complete documentation structure: - Frontend architecture documentation - Database schema documentation - Deployment guides (Docker, Traefik, Authentik, Environment) - Development guides (Setup, Testing, Contributing, Quality Gates) - Deployment architecture documentation - Updated docs README with complete navigation All new features and APIs are now documented. Quality gates: docs only, no code changes
1.1 KiB
1.1 KiB
API Documentation
Overview
The Headquarter API is a RESTful API built with FastAPI. All endpoints (except auth) require authentication via session cookie.
Base URL
- Development:
http://localhost:8000 - Production:
https://api.yourdomain.com
Authentication
Most endpoints require authentication. Include the session cookie in requests:
curl http://api.example.com/endpoint \
-H "Cookie: session=your_session_cookie"
Response Format
All responses are JSON. Error responses follow this format:
{
"detail": "Error message"
}
API Sections
- Auth - Authentication endpoints
- Projects - Project management
- Repositories - Git repositories and file operations
- Users - User management and settings
- Tool Types - Tool type management
- SSH Keys - SSH key management
Testing
Interactive API documentation is available at /docs when running the backend:
http://localhost:8000/docs
This provides:
- Interactive endpoint testing
- Request/response schemas
- Authentication via "Authorize" button