# API Endpoints Reference

## Complete Endpoint List

| Method | Endpoint | Description | Auth |
|--------|----------|-------------|------|
| GET | `/api/v1/sections` | List all sections | No |
| GET | `/api/v1/sections/{id}` | Get section content | No |
| GET | `/api/v1/summary` | Get sections summary | No |
| GET | `/api/v1/search` | Search documentation | No |
| GET | `/api/v1/stats` | Get statistics | No |
| GET | `/api/v1/llm-optimized/{id}` | Get LLM-optimized content | No |
| GET | `/health` | Health check | No |
| GET | `/mcp/methods` | List MCP methods | Yes |
| GET | `/mcp/connections` | List connections | Yes |
| POST | `/mcp/execute/ssh` | Execute SSH command | Yes |
| POST | `/mcp/execute/snmp/get` | SNMP GET query | Yes |
| POST | `/mcp/execute/api` | API request | Yes |

## Response Formats

All API responses follow this structure:

### Success Response
```json
{
  "success": true,
  "data": { ... },
  "timestamp": "2025-01-20T10:30:00Z"
}
```

### Error Response
```json
{
  "success": false,
  "error": "Error message",
  "code": "ERROR_CODE",
  "timestamp": "2025-01-20T10:30:00Z"
}
```

## HTTP Status Codes

- `200` - Success
- `400` - Bad Request
- `401` - Unauthorized
- `404` - Not Found
- `429` - Too Many Requests
- `500` - Internal Server Error